Как искать подстроку в PHP через mb_strpos, strpos и stripos

Для поиска подстроки в PHP используйте strpos или mb_strpos, а результат сравнивайте с false строго. stripos ищет без учета регистра, mb_strpos считает позиции в символах UTF-8, а str_contains возвращает только ответ «да» или «нет». В статье есть готовые примеры, цикл поиска всех совпадений и безопасная проверка формы.

Как работает strpos: синтаксис и возвращаемое значение

Функция strpos ищет первое вхождение одной строки в другую. Сначала передайте строку, в которой идет поиск, затем искомую подстроку.

Документация PHP для strpos описывает такую сигнатуру:

strpos(string $haystack, string $needle, int $offset = 0): int|false
ПараметрНазначениеПример
haystackСтрока, внутри которой идет поиск'Привет, мир!'
needleИскомая подстрока'мир'
offsetПозиция, с которой начинается поиск0

Функция возвращает целое число с позицией первого совпадения. Отсчет начинается с нуля. Если подстрока отсутствует, PHP возвращает false.

Этот пример strpos в PHP показывает поиск с учетом регистра:

<?php
$text = 'Привет, PHP!';

var_dump(strpos($text, 'PHP'));
var_dump(strpos($text, 'php'));
var_dump(strpos($text, 'Java'));

Вывод:

int(14)
bool(false)
bool(false)

Функция находит «PHP» в байтовой позиции 14. Шесть русских букв занимают 12 байтов, запятая и пробел добавляют еще 2. Строка «php» отличается регистром, поэтому совпадение не появляется.

Для запуска сохраните код в файл search.php и выполните в терминале команду php search.php. Файлы с русским текстом сохраните в UTF-8. Примеры рассчитаны на PHP 8 и новее; для функций mb_* подключите расширение mbstring.

Почему проверять результат через === false

Позиция 0 превращается в false при обычной проверке if. Из-за этого условие сообщает об отсутствии совпадения в начале строки.

<?php
$text = 'PHP tutorial';
$position = strpos($text, 'PHP');

var_dump($position);

if ($position) {
    echo "Найдено\n";
} else {
    echo "Не найдено\n";
}

if ($position !== false) {
    echo "Позиция: $position\n";
}

Вывод:

int(0)
Не найдено
Позиция: 0

Сравнивайте результат с false строго. Проверка $position !== false сохраняет совпадение в позиции 0, а $position === false находит отсутствие строки.

<?php
$text = 'PHP tutorial';
$position = strpos($text, 'PHP');

if ($position !== false) {
    echo "Подстрока найдена в позиции $position";
} else {
    echo 'Подстрока не найдена';
}

Вывод:

Подстрока найдена в позиции 0

Поиск со смещением через offset

Положительный offset задает позицию от начала строки. Отрицательный offset начинает поиск с указанного отступа от конца строки; PHP поддерживает такой вариант с версии 7.1.

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

var_dump(strpos($text, 'one'));
var_dump(strpos($text, 'one', 1));
var_dump(strpos($text, 'one', -3));
var_dump(strpos($text, 'two', -3));

Вывод:

int(0)
int(8)
int(8)
bool(false)

Смещение -3 начинает поиск с последнего слова. Функция все равно возвращает позицию относительно начала всей строки.

Как найти все вхождения в цикле

После найденного совпадения увеличьте offset. Прибавление единицы сохраняет перекрывающиеся совпадения.

<?php
$text = 'banana';
$needle = 'ana';
$offset = 0;
$positions = [];

while (($position = strpos($text, $needle, $offset)) !== false) {
    $positions[] = $position;
    $offset = $position + 1;
}

echo implode(', ', $positions);

Вывод:

1, 3

Подстрока «ana» начинается в позициях 1 и 3. Для неперекрывающихся совпадений прибавьте длину needle:

$offset = $position + strlen($needle);

После такой замены пример выведет только 1.

Пустую подстроку отклоняйте до цикла. Иначе поиск будет возвращать совпадения в каждой позиции, а смещение может выйти за границы строки.

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

Функция stripos ищет подстроку без учета регистра. Она возвращает позицию первого совпадения или false, поэтому проверка через !== false остается обязательной.

stripos(string $haystack, string $needle, int $offset = 0): int|false
<?php
$text = 'PHP Tutorial';

var_dump(strpos($text, 'tutorial'));
var_dump(stripos($text, 'tutorial'));
var_dump(stripos($text, 'php'));

Вывод:

bool(false)
int(4)
int(0)

strpos не находит «tutorial» из-за разницы регистра. stripos находит его в позиции 4, а «php» – в позиции 0.

Для кириллицы в UTF-8 stripos не подходит для надежного регистронезависимого сопоставления. Используйте mb_stripos и явно передавайте кодировку 'UTF-8'.

Как использовать mb_strpos и mb_stripos в PHP для строк UTF-8

Обычный strpos возвращает байтовую позицию. mb_strpos считает символы выбранной кодировки, поэтому функция подходит для русских строк.

Документация mb_strpos содержит такую сигнатуру:

mb_strpos(string $haystack, string $needle, int $offset = 0, ?string $encoding = null): int|false
mb_stripos(string $haystack, string $needle, int $offset = 0, ?string $encoding = null): int|false

Передавайте 'UTF-8' явно. Исходная строка и needle должны использовать одну кодировку. В примере PHP функция mb_strpos возвращает позицию русского слова в символах.

<?php
$text = 'Привет, мир!';

var_dump(strpos($text, 'мир'));
var_dump(mb_strpos($text, 'мир', 0, 'UTF-8'));
var_dump(mb_strpos($text, 'МИР', 0, 'UTF-8'));
var_dump(mb_stripos($text, 'МИР', 0, 'UTF-8'));

Вывод:

int(14)
int(8)
bool(false)
int(8)

До слова «мир» идут 8 символов, но русские буквы занимают больше байтов. Поэтому strpos возвращает 14, а mb_strpos – 8. Функция mb_stripos игнорирует регистр и находит «МИР».

Проверьте, подключено ли расширение mbstring:

<?php
var_dump(extension_loaded('mbstring'));
var_dump(function_exists('mb_strpos'));

Вывод при подключенном расширении:

bool(true)
bool(true)

Консольный PHP и PHP веб-сервера могут использовать разные настройки. Проверяйте расширение в том окружении, где работает ваш код.

str_contains, str_starts_with и str_ends_with в PHP 8

Когда позиция совпадения не нужна, используйте функции с логическим результатом. str_contains, str_starts_with и str_ends_with появились в PHP 8.0.

  • str_contains ищет подстроку в любом месте.
  • str_starts_with проверяет начало строки.
  • str_ends_with проверяет конец строки.
<?php
$text = 'report.pdf';

var_dump(str_contains($text, 'port'));
var_dump(str_starts_with($text, 'report'));
var_dump(str_ends_with($text, '.pdf'));
var_dump(str_contains($text, 'PDF'));

Вывод:

bool(true)
bool(true)
bool(true)
bool(false)

Все три функции учитывают регистр. Они сравнивают байты и возвращают только логический результат. Для регистронезависимого поиска кириллицы используйте mb_stripos(...) !== false.

Сравнение функций поиска подстроки

Выбирайте функцию по регистру, типу строки и нужному результату. Для последнего совпадения используйте strrpos. Все перечисленные функции доступны в PHP 8; функции с префиксом mb_ требуют расширения mbstring.

ФункцияРегистрUTF-8Возвращаемое значениеТребования для примеров
strposУчитываетПозиция в байтахПервая позиция или falsePHP 8, без дополнительных расширений
striposИгнорирует ASCII-буквы независимо от локали (с PHP 8.2)Позиция в байтахПервая позиция или falsePHP 8, без дополнительных расширений
strrposУчитываетПозиция в байтахПоследняя позиция или falsePHP 8, без дополнительных расширений
mb_strposУчитываетПозиция в символах кодировкиПервая позиция или falsePHP 8 с mbstring
mb_striposИгнорируетПозиция в символах кодировкиПервая позиция или falsePHP 8 с mbstring
str_containsУчитываетПроверяет байтыtrue или falsePHP 8.0 и новее
<?php
$text = 'one two one';

var_dump(strpos($text, 'one'));
var_dump(strrpos($text, 'one'));

Вывод:

int(0)
int(8)

strpos возвращает первое совпадение, а strrpos – последнее. Отрицательный offset у strpos задает старт поиска вперед от конца строки. У strrpos отрицательное смещение ограничивает поиск в сторону начала строки.

Проверка ввода из формы на стоп-слова

Обработчик получает значение через $_POST['searchterm'] ?? '', удаляет пробелы функцией trim и отклоняет пустую строку. Затем mb_stripos ищет стоп-слова без учета регистра, а htmlspecialchars экранирует пользовательский текст перед выводом.

Сохраните следующий код в файл form.php в кодировке UTF-8. Расширение mbstring должно быть подключено.

<?php
header('Content-Type: text/html; charset=UTF-8');

$input = $_POST['searchterm'] ?? '';
$searchTerm = is_string($input) ? trim($input) : '';
$message = '';
$stopWords = ['спам', 'казино'];

if ($searchTerm === '') {
    $message = 'Введите текст.';
} else {
    $blocked = false;

    foreach ($stopWords as $word) {
        if (mb_stripos($searchTerm, $word, 0, 'UTF-8') !== false) {
            $blocked = true;
            break;
        }
    }

    $message = $blocked
        ? 'Текст содержит запрещенную подстроку.'
        : 'Текст принят.';
}

function escapeHtml(string $value): string
{
    return htmlspecialchars($value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
?>
<!doctype html>
<html lang="ru">
<head>
    <meta charset="UTF-8">
    <title>Проверка текста</title>
</head>
<body>
    <form method="post" accept-charset="UTF-8">
        <label for="searchterm">Текст</label>
        <input id="searchterm" name="searchterm" type="text"
               value="<?= escapeHtml($searchTerm) ?>">
        <button type="submit">Проверить</button>
    </form>

    <p><?= escapeHtml($message) ?></p>
    <p>Ваш ввод: <?= escapeHtml($searchTerm) ?></p>
</body>
</html>

Запустите форму через встроенный сервер PHP:

  1. Откройте терминал в каталоге, где сохранен файл form.php.
  2. Выполните команду php -S 127.0.0.1:8000. Оставьте терминал открытым, пока работаете с формой.
  3. Введите в адресной строке браузера http://127.0.0.1:8000/form.php. Страница покажет поле «Текст», кнопку «Проверить» и сообщение «Введите текст.».
  4. Введите Привет, мир! в поле «Текст» и нажмите «Проверить». Браузер отправит POST-запрос, а страница покажет результат обработки.

При отправке строки «Привет, мир!» страница выведет:

Текст принят.
Ваш ввод: Привет, мир!

При отправке строки «Это СПАМ» сработает регистронезависимый поиск:

Текст содержит запрещенную подстроку.
Ваш ввод: Это СПАМ

Чтобы остановить локальный сервер, нажмите Ctrl+C в терминале. Встроенный сервер используйте для локальных примеров, без публикации в интернете.

Экранируйте и текст в поле, и сообщение на странице. Такой вывод покажет строку <em>Привет</em> как текст, а браузер не воспримет ее как HTML.

Проверка стоп-слов ищет подстроки, поэтому она обнаружит «спам» и внутри слова «спамер». Сам список стоп-слов не защищает от XSS: безопасный вывод обеспечивает htmlspecialchars.

Ошибки при поиске подстроки через strpos

Проверьте типы аргументов, кодировку и правило для пустой подстроки до вызова функции.

  • Сравнение через ==. Позиция 0 совпадает с false при нестрогом сравнении. Используйте !== false.
  • Перепутанный порядок аргументов. Передавайте сначала haystack, затем needle.
  • Байтовая позиция в кириллице. Для номера символа используйте mb_strpos с кодировкой 'UTF-8'.
  • Пустая needle. В PHP 8 пустая строка возвращает позицию 0 при offset 0. Отклоняйте пустую needle, если ваша задача требует непустой подстроки.
  • Число вместо строки. До PHP 8.0 числовая needle трактовалась как код символа. В PHP 7.3 такое поведение пометили устаревшим, а PHP 8 убрал эту трактовку. Передавайте строковое значение; при строгой типизации число вызовет TypeError.
<?php
declare(strict_types=1);

$text = 'order-123';
var_dump(strpos($text, '123'));
var_dump(strpos($text, ''));

Вывод в PHP 8:

int(6)
int(0)

Проверка с ===, правильный порядок аргументов и явная кодировка устраняют основные ошибки поиска.

Комментарии

Оставьте свой комментарий
Пока никто не оставил комментариев