PHPTime

Регулярные выражения в 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
<?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
<?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
<?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
<?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
<?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
<?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.

Чек-лист перед использованием регулярного выражения

  1. Выберите функцию под задачу. preg_match() ищет первое совпадение, preg_match_all() собирает все, preg_replace() выполняет обычную замену, preg_replace_callback() вычисляет её.
  2. Для проверки всей строки поставьте \A и \z. Захватывайте только те части, которые понадобятся после поиска.
  3. Укажите нужный набор символов. Для UTF-8 оцените, нужны ли u, Unicode-свойства и регистронезависимый поиск. Для идентификаторов проверьте, допустимы ли символы за пределами ASCII.
  4. Обработайте ошибки отдельно от успешного поиска без совпадений. Экранируйте переменные фрагменты шаблона с помощью preg_quote().
  5. Проверьте пустой вход, завершающий перевод строки, необязательные группы и длинную строку с ошибкой в конце. Для UTF-8 добавьте примеры с кириллицей, комбинируемыми знаками и повреждёнными байтами.

Частые вопросы

Почему preg_match возвращает 0 или false?

0 означает, что поиск завершился без совпадения. false означает ошибку. Используйте строгое сравнение и сразу после ошибки получите диагностику через preg_last_error_msg().

Как вставить переменную в регулярное выражение PHP?

Если переменная должна совпасть с буквальным текстом, передайте её в preg_quote() вместе с разделителем шаблона и вставьте полученный фрагмент между разделителями.

Как сделать только одну замену через preg_replace?

Для одного шаблона и одной входной строки передайте 1 четвёртым аргументом. Функция заменит первое совпадение. Пятый аргумент покажет, выполнилась ли замена.

Справка по теме

Ещё в разделе «Справочник PHP»

Редирект в PHP: header Location, коды 301 и 302

Как сделать редирект в PHP через header Location, выбрать между 301, 302, 303, 307 и 308, обработать POST и исправить ошибку headers already sent.

9 мин

Сессии в PHP: session_start, хранение данных и безопасность

Как запустить сессию в PHP через session_start, хранить данные в $_SESSION, настроить cookie, сменить идентификатор при входе и завершить сессию.

8 мин

Сортировка массивов в PHP: sort, usort, ksort и другие

Как сортировать массивы в PHP 8.3–8.5 по значениям, ключам и полям: примеры sort, usort, ksort и array_multisort, флаги сравнения и типичные ошибки.

8 мин

Строки в PHP: длина, поиск, замена и обрезка

Как узнать длину строки в PHP, найти и вырезать подстроку, заменить или удалить текст, обрезать пробелы и обработать переносы строк в PHP 8.3–8.5.

10 мин