strpos() w PHP: pozycja podciągu w stringu

strpos($haystack, $needle) zwraca pozycję pierwszego $needle w $haystack, liczoną od 0, albo false, jeśli go tam nie ma. Zawsze sprawdzaj wynik przez !== false, bo dopasowanie na początku zwraca 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";
}

Jeśli w PHP 8 potrzebujesz tylko odpowiedzi tak lub nie, czytelniejsza jest str_contains(). Używaj strpos(), gdy liczy się pozycja.

Składnia

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

Wyszukiwanie rozróżnia wielkość liter. $offset mówi, gdzie zacząć szukanie; ujemny offset liczy od końca stringa.

Pułapka !== false

0 i false są równe przy luźnym porównaniu (==). Dopasowanie na pozycji 0 jest więc traktowane jak „nie znaleziono” przez każde sprawdzenie, które nie jest ścisłe.

<?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";
}

Ta sama zasada dotyczy stripos(), strrpos() i array_search(), które wszystkie mogą zwrócić 0 dla prawdziwego dopasowania.

Wyszukiwanie bez rozróżniania wielkości liter przez stripos

stripos() przyjmuje te same argumenty i ignoruje wielkość liter 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

Ostatnie wystąpienie przez strrpos

strrpos() zwraca pozycję ostatniego dopasowania. To standardowy sposób na pobranie rozszerzenia pliku albo ostatniego segmentu ścieżki.

<?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";

Dla nazw plików pathinfo($file, PATHINFO_EXTENSION) robi to za ciebie. Cięcie stringa w danej pozycji opisuje strona substr().

Rozpoczęcie wyszukiwania od offsetu

Trzeci argument pomija początek stringa. Ujemny offset zaczyna tyle znaków przed końcem.

<?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

Znajdowanie wszystkich wystąpień

strpos() znajduje jedno dopasowanie. Aby znaleźć wszystkie, użyj pętli i przesuwaj offset za każde dopasowanie:

<?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";

Potrzebujesz tylko liczby? substr_count($text, 'the') jest krótsze. Dla wzorców preg_match_all() z PREG_OFFSET_CAPTURE zwraca każde dopasowanie z jego pozycją.

Tekst japoński: pozycja w bajtach a pozycja w znakach

strpos() poprawnie znajduje tekst wielobajtowy, ale zwraca liczbę w bajtach. Kana i popularne kanji zajmują w UTF-8 po 3 bajty, więc w tekście w całości japońskim pozycja w bajtach jest trzy razy większa niż w znakach, a w tekście mieszanym (także z polskimi literami) obie wartości rozjeżdżają się w mniej oczywisty sposób. mb_strpos() zwraca znaki, czyli to, czego oczekuje 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";

Mieszanie obu to klasyczny błąd: przekazanie wyniku strpos() do mb_substr() zaczyna za daleko w stringu. Używaj strpos z substr, a mb_strpos z mb_substr.