PHP strpos(): trovare la posizione di una sottostringa

strpos($haystack, $needle) restituisce la posizione del primo $needle dentro $haystack, contata da 0, oppure false se non c'è. Verifica sempre il risultato con !== false, perché una corrispondenza all'inizio restituisce 0.

<?php
$text = 'apple, banana, cherry';

var_dump(strpos($text, 'banana'));   // found at position 7
var_dump(strpos($text, 'apple'));    // found at position 0
var_dump(strpos($text, 'grape'));    // not found

if (strpos($text, 'apple') !== false) {
    echo "Found apple\n";
}

Se su PHP 8 ti basta una risposta sì o no, str_contains() è più chiara. Usa strpos() quando la posizione conta.

Sintassi

strpos(string $haystack, string $needle, int $offset = 0): int|false

La ricerca distingue maiuscole e minuscole. $offset indica da dove iniziare a cercare; un offset negativo conta dalla fine della stringa.

La trappola di !== false

0 e false sono uguali nel confronto debole (==). Una corrispondenza alla posizione 0 viene quindi trattata come "non trovato" da qualsiasi controllo non stretto.

<?php
$url = 'https://example.com';

// Wrong: position 0 is falsy, so this says "no"
if (strpos($url, 'https')) {
    echo "wrong check: has https\n";
} else {
    echo "wrong check: no https\n";
}

// Right: compare strictly with false
if (strpos($url, 'https') !== false) {
    echo "right check: has https\n";
}

La stessa regola vale per stripos(), strrpos() e array_search(), che possono tutte restituire 0 per una corrispondenza reale.

Ricerca senza distinzione tra maiuscole e minuscole con stripos

stripos() accetta gli stessi argomenti e ignora maiuscole e minuscole delle lettere ASCII.

<?php
$title = 'Learning PHP the Hard Way';

var_dump(strpos($title, 'php'));    // case-sensitive: not found
var_dump(stripos($title, 'php'));   // found at 9

Trovare l'ultima occorrenza con strrpos

strrpos() restituisce la posizione dell'ultima corrispondenza. È il modo standard per ottenere l'estensione di un file o l'ultimo segmento di un percorso.

<?php
$file = 'archive.backup.tar.gz';

$dot = strrpos($file, '.');
echo substr($file, $dot + 1), "\n";      // gz
echo substr($file, 0, $dot), "\n";       // archive.backup.tar

$path = '/var/www/html/index.php';
echo substr($path, strrpos($path, '/') + 1), "\n";

Per i nomi di file in particolare, pathinfo($file, PATHINFO_EXTENSION) lo fa per te. Tagliare la stringa alla posizione è trattato nella pagina su substr().

Iniziare la ricerca da un offset

Il terzo argomento salta l'inizio della stringa. Un offset negativo parte quel numero di caratteri prima della fine.

<?php
$s = 'one two one two';

var_dump(strpos($s, 'one'));        // 0
var_dump(strpos($s, 'one', 1));     // skip position 0: finds the second one
var_dump(strpos($s, 'two', -3));    // search only the last 3 characters

Trovare tutte le occorrenze

strpos() trova una corrispondenza. Usa un ciclo e sposta l'offset oltre ogni corrispondenza per trovarle tutte:

<?php
$text = 'the cat sat on the mat with the hat';
$needle = 'the';

$positions = [];
$offset = 0;
while (($pos = strpos($text, $needle, $offset)) !== false) {
    $positions[] = $pos;
    $offset = $pos + strlen($needle);
}

print_r($positions);
echo count($positions), " matches\n";

Ti serve solo il conteggio? substr_count($text, 'the') è più breve. Per gli schemi, preg_match_all() con PREG_OFFSET_CAPTURE restituisce ogni corrispondenza con la sua posizione.

Testo giapponese: posizione in byte e posizione in caratteri

strpos() trova correttamente il testo multibyte, ma il numero che restituisce è in byte. In UTF-8 i kana e i kanji comuni occupano 3 byte ciascuno, quindi in un testo tutto giapponese la posizione in byte è il triplo di quella in caratteri, e in un testo misto le due si allontanano in modi meno evidenti. mb_strpos() restituisce i caratteri, ed è ciò che si aspetta mb_substr().

<?php
$s = '東京都渋谷区';

var_dump(strpos($s, '渋谷'));      // byte position
var_dump(mb_strpos($s, '渋谷'));   // character position

echo mb_substr($s, mb_strpos($s, '渋谷')), "\n";

Mescolare le due è un bug classico: passare un risultato di strpos() a mb_substr() parte troppo avanti nella stringa. Usa strpos con substr, e mb_strpos con mb_substr.