PHP strpos(): найти позицию подстроки

strpos($haystack, $needle) возвращает позицию первого $needle внутри $haystack, считая с 0, или false, если его там нет. Всегда проверяйте результат через !== false, потому что совпадение в начале возвращает 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";
}

Если в PHP 8 нужен только ответ "да" или "нет", str_contains() понятнее. Используйте strpos(), когда важна позиция.

Синтаксис

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

Поиск учитывает регистр. $offset задаёт, откуда начинать поиск; отрицательное смещение отсчитывается с конца строки.

Ловушка !== false

0 и false равны при нестрогом сравнении (==). Поэтому любая нестрогая проверка считает совпадение на позиции 0 "не найденным".

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

То же правило касается stripos(), strrpos() и array_search(): все они могут вернуть 0 для настоящего совпадения.

Поиск без учёта регистра через stripos

stripos() принимает те же аргументы и не учитывает регистр 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

Последнее вхождение через strrpos

strrpos() возвращает позицию последнего совпадения. Это стандартный способ получить расширение файла или последний сегмент пути.

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

Для имён файлов это за вас делает pathinfo($file, PATHINFO_EXTENSION). Как вырезать часть строки по позиции, рассказано на странице substr().

Поиск со смещением

Третий аргумент пропускает начало строки. Отрицательное смещение начинает за столько символов до конца.

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

Поиск всех вхождений

strpos() находит одно совпадение. Чтобы найти все, используйте цикл и сдвигайте смещение за каждое совпадение:

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

Нужно только количество? Короче substr_count($text, 'the'). Для шаблонов preg_match_all() с PREG_OFFSET_CAPTURE возвращает каждое совпадение с его позицией.

Японский текст: позиция в байтах и позиция в символах

strpos() правильно находит многобайтовый текст, но возвращает число в байтах. Кана и распространённые иероглифы занимают в UTF-8 по 3 байта, поэтому в тексте целиком на японском позиция в байтах втрое больше позиции в символах, а в смешанном тексте они расходятся менее очевидно. mb_strpos() возвращает символы, а именно этого ждёт 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";

Смешивать их это классическая ошибка: результат strpos(), переданный в mb_substr(), начинает слишком далеко от начала строки. Используйте strpos вместе с substr, а mb_strpos вместе с mb_substr.