Как искать подстроку в PHP через mb_strpos, strpos и stripos
Для поиска подстроки в PHP используйте strpos или mb_strpos, а результат сравнивайте с false строго. stripos ищет без учета регистра, mb_strpos считает позиции в символах UTF-8, а str_contains возвращает только ответ «да» или «нет». В статье есть готовые примеры, цикл поиска всех совпадений и безопасная проверка формы.
- Как работает strpos: синтаксис и возвращаемое значение
- Почему проверять результат через === false
- Поиск со смещением через offset
- Поиск без учета регистра через stripos
- Как использовать mb_strpos и mb_stripos в PHP для строк UTF-8
- str_contains, str_starts_with и str_ends_with в PHP 8
- Сравнение функций поиска подстроки
- Проверка ввода из формы на стоп-слова
- Ошибки при поиске подстроки через strpos
Как работает 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 | Учитывает | Позиция в байтах | Первая позиция или false | PHP 8, без дополнительных расширений |
stripos | Игнорирует ASCII-буквы независимо от локали (с PHP 8.2) | Позиция в байтах | Первая позиция или false | PHP 8, без дополнительных расширений |
strrpos | Учитывает | Позиция в байтах | Последняя позиция или false | PHP 8, без дополнительных расширений |
mb_strpos | Учитывает | Позиция в символах кодировки | Первая позиция или false | PHP 8 с mbstring |
mb_stripos | Игнорирует | Позиция в символах кодировки | Первая позиция или false | PHP 8 с mbstring |
str_contains | Учитывает | Проверяет байты | true или false | PHP 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:
- Откройте терминал в каталоге, где сохранен файл
form.php. - Выполните команду
php -S 127.0.0.1:8000. Оставьте терминал открытым, пока работаете с формой. - Введите в адресной строке браузера
http://127.0.0.1:8000/form.php. Страница покажет поле «Текст», кнопку «Проверить» и сообщение «Введите текст.». - Введите
Привет, мир!в поле «Текст» и нажмите «Проверить». Браузер отправит 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)Проверка с ===, правильный порядок аргументов и явная кодировка устраняют основные ошибки поиска.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Как сделать переход на другую страницу в PHP 5 мин чтения
- Как создать календарь на AJAX и PHP 5 мин чтения
- Создание форм регистрации и авторизации на PHP 7 мин чтения
- База данных картинка: загрузка на сервер или в MySQL через PHP 12 мин чтения
Комментарии