Регулярные выражения в PHP: preg_match, preg_replace и шаблоны
Регулярные выражения в PHP помогают проверить формат строки, извлечь из неё данные или заменить фрагменты по шаблону. Разберём синтаксис PCRE2, группы захвата, обработку ошибок и особенности PHP 8.3–8.5.
Как устроены регулярные выражения в PHP
Функции семейства preg_* используют движок PCRE2. Шаблон передают строкой, в которой есть разделители, само выражение и необязательные модификаторы. Например, в ~\A[a-z]+\z~i символы ~ ограничивают выражение, \A и \z обозначают границы всей строки, а i включает поиск без учёта регистра. Шаблон принимает одну или несколько латинских букв.
| Синтаксис | Что означает |
|---|---|
[A-Z], [^0-9] | Один символ из диапазона или один символ вне указанного набора |
. | Один символ, по умолчанию с исключением перевода строки |
?, *, +, {2,4} | Ноль или одно, ноль или больше, одно или больше, от двух до четырёх повторений предыдущего элемента |
(...), (?:...) | Группа с захватом и группа без захвата |
a|b | Альтернатива, a или b |
\A, \z | Абсолютное начало и абсолютный конец строки |
\p{L}, \p{Nd} | Буква и десятичная цифра из категорий Unicode |
Разделитель выбирайте под содержимое. Для пути вроде /catalog/42 удобен ~, потому что слеши внутри шаблона можно оставить как есть. Для буквальной точки нужна запись \., для буквального разделителя ~ внутри шаблона — \~. Если задача сводится к поиску или замене фиксированной подстроки, подходят str_contains() и str_replace().
PHP preg_match — проверка и извлечение данных
preg_match($pattern, $subject, $matches) ищет первое совпадение. Функция возвращает 1 при совпадении, 0 при его отсутствии и false при ошибке. Проверяйте эти результаты строго. В $matches[0] записывается полное совпадение, а следующие элементы содержат группы захвата. Именованная группа (?<name>...) доступна и по имени, и по номеру.
<?php
declare(strict_types=1);
$input = 'ORD-004216';
$result = preg_match('~\AORD-(?<number>[0-9]{6})\z~', $input, $matches);
if ($result === false) {
throw new RuntimeException(preg_last_error_msg());
}
if ($result === 1) {
echo $matches['number']; // 004216, ведущие нули сохранены
} else {
echo 'Неверный формат номера заказа';
}Для проверки всей строки используйте \A...\z. Якорь $ по умолчанию может совпасть перед завершающим переводом строки. С модификатором m якоря ^ и $ также работают на границах отдельных строк. Проверка регулярным выражением отвечает за формат. Например, шаблон даты может проверить расположение цифр, а календарную корректность следует проверять отдельно.
Все совпадения, необязательные группы и позиции
preg_match_all() возвращает число неперекрывающихся совпадений или false при ошибке. По умолчанию данные сгруппированы по номеру или имени группы. Флаг PREG_SET_ORDER даёт отдельный массив для каждого совпадения. С PREG_UNMATCHED_AS_NULL необязательная группа, которая не участвовала в совпадении, получает null. Так её можно отличить от группы, захватившей пустую строку.
<?php
$text = 'id=42 id=7:active';
$count = preg_match_all(
'~id=(?<id>[0-9]+)(?::(?<status>[a-z]+))?~',
$text,
$rows,
PREG_SET_ORDER | PREG_UNMATCHED_AS_NULL,
);
if ($count === false) {
throw new RuntimeException(preg_last_error_msg());
}
var_export(array_column($rows, 'status')); // [null, 'active']Флаг PREG_OFFSET_CAPTURE возвращает для каждого захвата пару «текст, позиция». Позиции измеряются в байтах даже с модификатором u, поэтому их можно использовать с substr(). Аргумент offset у preg_match() тоже задаётся в байтах. Он указывает, откуда начинать поиск, при этом \A продолжает обозначать начало исходной строки.
PHP preg_replace — замена по шаблону
preg_replace($pattern, $replacement, $subject) по умолчанию заменяет все неперекрывающиеся совпадения. Для строкового входа результатом будет строка. При отсутствии совпадений она сохранит исходное содержимое. При ошибке функция возвращает null. Четвёртый аргумент ограничивает число замен, а пятый позволяет получить их количество. Значение -1 снимает ограничение.
<?php
declare(strict_types=1);
$input = '2026-11-19, 2026-12-01';
$output = preg_replace(
'~\b([0-9]{4})-([0-9]{2})-([0-9]{2})\b~',
'$3.$2.$1',
$input,
-1,
$count,
);
if ($output === null) {
throw new RuntimeException(preg_last_error_msg());
}
echo $output; // 19.11.2026, 01.12.2026
echo PHP_EOL, $count; // 2 заменыВ строке замены $0 означает полное совпадение, $1 — первую группу. Если сразу после ссылки должна идти цифра, отделите номер группы фигурными скобками. Например, '${1}0' дописывает ноль к содержимому первой группы, тогда как '$10' обращается к десятой группе. Одинарные кавычки сохраняют выражение ${1} для обработки функцией.
Вычисляемая замена через preg_replace_callback
Колбэк получает массив захватов и возвращает строку для каждого совпадения. Он подходит для вычислений, работы с именованными группами и подстановки текста, в котором $1 должен остаться буквальным. Возвращённая колбэком строка вставляется целиком.
<?php
$labels = ['plan' => 'Стандарт', 'price' => '$19'];
$output = preg_replace_callback(
'~\{(?<key>[a-z]+)\}~',
static fn (array $match): string => $labels[$match['key']] ?? $match[0],
'Тариф {plan}, цена {price}, метка {unknown}',
);
if ($output === null) {
throw new RuntimeException(preg_last_error_msg());
}
echo $output; // Тариф Стандарт, цена $19, метка {unknown}Шаблоны PHP для кириллицы и Unicode
Модификатор u включает режим UTF-8 для шаблона и входной строки. Для букв используйте \p{L}, для комбинируемых знаков — \p{M}. Например, буква с диакритикой может быть представлена одной кодовой точкой или буквой с отдельным комбинируемым знаком. Следующий шаблон принимает оба варианта и разрешает один дефис или пробел между частями имени.
<?php
$name = 'Анна-Мария';
$pattern = '~\A\p{L}[\p{L}\p{M}]*(?:[ -]\p{L}[\p{L}\p{M}]*)*\z~u';
$result = preg_match($pattern, $name);
if ($result === false) {
throw new RuntimeException(preg_last_error_msg());
}
var_dump($result === 1); // trueДля идентификаторов с цифрами ASCII задавайте [0-9], а для десятичных цифр всех письменностей — \p{Nd}. Если в шаблоне важны сокращения \w, \d, \s или граница \b, учитывайте режим Unicode-свойств (*UCP). Например, ~(*UCP)\bслово\b~ui определяет границы слова через Unicode-семантику \w. Для обработки некорректной UTF-8 проверяйте ошибку функции. Код PREG_BAD_UTF8_ERROR можно получить через preg_last_error().
Типичные ошибки при работе с preg_match и preg_replace
- Проверка результата через
if (!$result). Дляpreg_match()она даёт одну ветку для отсутствия совпадения и ошибки. Проверяйте=== falseотдельно. Дляpreg_replace()проверяйте=== null, поскольку пустая строка может быть корректным результатом. - Вставка пользовательского текста в шаблон. Перед вставкой буквального фрагмента вызовите
preg_quote($fragment, '~'), где~— выбранный разделитель. Для строки замены действуют свои правила, поэтому буквальную динамическую замену удобнее возвращать из колбэка. - Смешение экранирования PHP и PCRE2. Обратный слеш обрабатывается на двух уровнях. Одинарные кавычки удобны для записи
\dи\p{L}. Чтобы шаблон искал буквальный обратный слеш, PCRE2 должен получить два слеша, а в строковом литерале PHP в одинарных кавычках нужно записать четыре. - Путаница между
mиs. Модификаторmменяет поведение якорей^и$. Модификаторsразрешает точке захватывать перевод строки. Если нужен текст до ближайшего разделителя, часто точнее задать класс вроде[^;]*, который исключает сам разделитель. - Пересекающиеся вложенные квантификаторы. В шаблоне
~\A(a+)+\z~при неудачном совпадении движок может перебрать много способов разделить буквы между повторами. Для той же проверки достаточно~\Aa+\z~. ПриPREG_BACKTRACK_LIMIT_ERRORсначала упростите выражение и проверьте его на длинном входе с несовпадением в конце.
<?php
$fragment = 'price+tax ~ total';
$pattern = '~' . preg_quote($fragment, '~') . '~';
// Плюс и тильда ищутся как обычные символы.
var_dump(preg_match($pattern, 'Поле: price+tax ~ total') === 1);Синтаксическая ошибка в шаблоне также может вызвать E_WARNING. Если нужно сохранить диагностическое сообщение PCRE2, считывайте preg_last_error_msg() сразу после ошибки, пока другой вызов preg_* не изменил состояние.
Что различается между PHP 8.3, 8.4 и 8.5
Примеры выше рассчитаны на все три ветки. При переносе шаблонов между версиями учитывайте возможности PCRE2 и минимальную версию PHP, на которой запускается проект:
- PHP 8.3. Для общего кода используйте синтаксис, доступный в этой ветке, например
{0,3}вместо сокращённого{,3}. Модификаторrв PHP 8.3 недоступен. - PHP 8.4. Обновление PCRE2 добавило запись
{,3}для диапазона от нуля до трёх повторений. Появился модификаторr. В сочетании сiиuон запрещает совпадения без учёта регистра между ASCII и символами за его пределами. Например,~\Ak\z~iuможет принять знак КельвинаK, а~\Ak\z~iurисключает его. - PHP 8.5. Можно использовать показанные формы вызова и синтаксис из PHP 8.4. Для проекта, который одновременно работает на PHP 8.3–8.5, сохраняйте совместимый синтаксис и прогоняйте тесты регулярных выражений на каждой целевой ветке. Версию движка в конкретном окружении показывает константа
PCRE_VERSION.
Чек-лист перед использованием регулярного выражения
- Выберите функцию под задачу.
preg_match()ищет первое совпадение,preg_match_all()собирает все,preg_replace()выполняет обычную замену,preg_replace_callback()вычисляет её. - Для проверки всей строки поставьте
\Aи\z. Захватывайте только те части, которые понадобятся после поиска. - Укажите нужный набор символов. Для UTF-8 оцените, нужны ли
u, Unicode-свойства и регистронезависимый поиск. Для идентификаторов проверьте, допустимы ли символы за пределами ASCII. - Обработайте ошибки отдельно от успешного поиска без совпадений. Экранируйте переменные фрагменты шаблона с помощью
preg_quote(). - Проверьте пустой вход, завершающий перевод строки, необязательные группы и длинную строку с ошибкой в конце. Для UTF-8 добавьте примеры с кириллицей, комбинируемыми знаками и повреждёнными байтами.
Частые вопросы
Почему preg_match возвращает 0 или false?
0 означает, что поиск завершился без совпадения. false означает ошибку. Используйте строгое сравнение и сразу после ошибки получите диагностику через preg_last_error_msg().
Как вставить переменную в регулярное выражение PHP?
Если переменная должна совпасть с буквальным текстом, передайте её в preg_quote() вместе с разделителем шаблона и вставьте полученный фрагмент между разделителями.
Как сделать только одну замену через preg_replace?
Для одного шаблона и одной входной строки передайте 1 четвёртым аргументом. Функция заменит первое совпадение. Пятый аргумент покажет, выполнилась ли замена.