PHP: полный мануал с примерами, функциями и ООП

Сначала полезный результат: проверить код товара

В заявке пришёл код BR41. Нужно понять, начинается ли он с BR и заканчивается ли цифрами, затем получить эти цифры. Регулярное выражение — маленькое правило формы текста; preg_match применяет его к строке. Правило не знает, существует ли товар, и не заменяет проверку склада. Начнём с одного вызова, затем раскроем его запись и расширим задачу. Полный официальный раздел PCRE здесь включает все функции, настройки и вложенные темы языка; редкие конструкции идут после основ.

Сохраните пример в UTF-8-файл regex-demo.php без BOM и выполните установленным PHP CLI. <?php начинает PHP-код; $code — имя переменной, = присваивает ей значение, кавычки задают текст, ; завершает команду. Скобки после preg_match передают аргументы через запятую: сначала правило, затем исходную строку. $found сохраняет ответ; echo выводит его. "\n" в двойных кавычках — перевод строки. Первый запуск PHP показывает запуск по шагам.

<?php
$code = 'BR41';
$found = preg_match('~\ABR[0-9]+\z~', $code);
echo $found, "\n";

1

У preg_match три разных ответа: 1 найдено, 0 не найдено, false техническая ошибка. Оператор === сравнивает и значение, и тип. if (...) выполняет блок в { ... } только при истинном условии, elseif проверяет следующую ветвь, else — оставшийся случай. echo печатает своё сообщение: один голый false на экране был бы незаметен.

<?php
$code = 'BR?';
$found = preg_match('~\ABR[0-9]+\z~', $code);
if ($found === false) {
    echo "Проверка не выполнилась\n";
} elseif ($found === 1) {
    echo "Форма кода подходит\n";
} else {
    echo "После BR нужны цифры\n";
}

После BR нужны цифры

Дальше понадобятся массивы для нескольких совпадений, foreach для их обхода, function/return для повторного использования и callback-функции для вычисляемой замены. Текущие примеры вводят местный синтаксис до использования; ссылки помогают вернуться к языковой основе. Вложенные (...), условия рядом и рекурсия не нужны, чтобы выполнить первые два примера.

Как выбрать функцию и когда обойтись без regex

Выберите действие по результату, который действительно нужен. Буквальный поиск и разбиение проще без regex; регулярное правило окупается, когда форма меняется, есть поля или несколько видов разделителя.

Поиск идёт слева направо по subject, но внутри одной попытки возможен возврат — backtracking. Левейшее успешное совпадение не обязательно самое длинное. PHP сохраняет compiled patterns в cache до 4096 на thread, очищая старые неиспользуемые записи партиями; размер не настраивается. Это не cache результатов и не гарантия общей памяти между HTTP-запросами. Не собирайте бесконечно разные шаблоны, если можно вынести меняющиеся данные в обычный словарь.

Установка и версия: PHP, PCRE2 и JIT

pcre встроено в PHP и всегда доступно в стандартной поддерживаемой сборке. На Windows не нужно добавлять extension=pcre в php.ini. Сначала проверьте тот executable, который запускает задачу: PHP_VERSION и PCRE_VERSION — разные версии. Здесь новые run проверены на PHP8.5.11 / PCRE2 10.44; другой PHP может быть собран с другой библиотекой.

<?php
echo 'PHP ', PHP_VERSION, "\n";
echo 'PCRE ', PCRE_VERSION, "\n";
echo 'JIT support: ', PCRE_JIT_SUPPORT ? 'yes' : 'no', "\n";
echo 'JIT setting: ', ini_get('pcre.jit'), "\n";

Обычная сборка использует bundled PCRE2 и по умолчанию поддерживает JIT. На не-Windows сборщик может выбрать --with-external-pcre (минимум10.30), а --without-pcre-jit отключает JIT при сборке. На Windows используется bundled library. Это сведения для администратора сборки, не инструкция менять ваш компьютер. Установка CLI и отличие конфигурации веб-SAPI — в отдельной главе.

Таблица — история обновлений bundled library, не обещание полного соответствия любого дистрибутива. Старые выпуски PCRE1 в PHP.net связаны с CVE-исправлениями; перенос приложения должен включать поддерживаемую PHP-ветвь целиком, а не ручную замену одного DLL. PHP8.4 добавляет r и новые возможности bundled10.44; PHP8.2 — внешний n. Для external PCRE смотрите реальный PCRE_VERSION. Устанавливать ничего для примеров этой главы не нужно.

Три настройки и отдельные пределы компиляции

Есть три настройки PCRE, все INI_ALL: их можно менять разрешёнными механизмами соответствующей SAPI, включая ini_set. Но это три разных ограничения/переключателя, а не одна «максимальная длина строки». Текущее ini_get может отличаться от factory default. Для CLI и FPM проверяйте каждую конфигурацию отдельно.

<?php
declare(strict_types=1);

$old = ini_set('pcre.backtrack_limit', '5000');
if ($old === false) { throw new RuntimeException('Setting is unavailable'); }
try { echo ini_get('pcre.backtrack_limit'), "\n"; }
finally { ini_set('pcre.backtrack_limit', $old); }
echo ini_get('pcre.backtrack_limit') === $old ? 'Восстановлено' : 'Не восстановлено';
echo "\n";

5000
Восстановлено

Стартовые (*LIMIT_MATCH=n), (*LIMIT_DEPTH=n), (*LIMIT_HEAP=n) позволяют шаблону снизить соответствующие ограничения, не поднять лимиты вызывающей стороны. HEAP в KiB относится к interpreter, DEPTH не действует для JIT; исторический LIMIT_RECURSION остаётся alias DEPTH. PHP не предоставляет общую настройку таймаута regex. Не подставляйте отрицательные/огромные числа «для отключения защиты». Компиляция имеет собственные пределы: примерно64K code units compiled pattern при default2-byte linkage, до65535captures, default250 вложенных групп, variable lookbehind по умолчанию255. Эти величины могут зависеть от сборки, а исходная длина pattern не равна compiled size. Некоторые upstream ман-страницы от10.43 всё ещё пишут32 для имени capture, но tagged10.44 и PHP.net subpatterns фиксируют128; не переносите старую таблицу без версии.

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

Все константы: флаги, ошибки и версия

Константа — именованное значение PHP без знака $. Она объясняет намерение и избавляет от запоминания чисел. Есть флаги, коды ошибок и сведения о сборке: их нельзя смешивать, даже если внутреннее число случайно совпало. Оператор | объединяет совместимые биты флагов; это не логическое ||.

<?php
declare(strict_types=1);

preg_match('~BR[0-9]+~', 'x BR41', $plain);
preg_match('~BR[0-9]+~', 'x BR41', $position, PREG_OFFSET_CAPTURE);
echo $plain[0], "\n";
echo $position[0][0], '@', $position[0][1], "\n";
echo preg_last_error() === PREG_NO_ERROR ? 'Без ошибки' : 'Ошибка';
echo "\n";

BR41
BR41@2
Без ошибки

Развёрнутые применения flags есть в карточках preg_match_all, preg_split и preg_grep. PREG_PATTERN_ORDER и PREG_SET_ORDER выбирают альтернативные формы, их не нужно объединять. Набор поддерживаемых flags зависит от функции: недопустимая комбинация в современном PHP может вызвать ValueError, поэтому не передавайте «все флаги сразу».

Четыре разных ситуации: найдено, не найдено, правило сломано, ввод повреждён

Перед сохранением кода заказа важно понимать, что проверка действительно состоялась. 0 — нормальное отсутствие совпадения; false/null зависят от выбранной функции и требуют диагностики. Неправильный regex вызывает warning при компиляции; неверный тип аргумента может бросить исключение PHP ещё до поиска. Ошибка runtime (UTF-8, лимит) обычно отражается return и последним PCRE-кодом.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level) use (&$warnings): bool {
    if ($level === E_WARNING) { ++$warnings; return true; }
    return false;
});
try { $result = preg_match('~[~', 'BR41'); }
finally { restore_error_handler(); }
echo $result === false ? 'Правило не скомпилировано' : 'Готово';
echo '/', $warnings, "\n";

Правило не скомпилировано/1

<?php
declare(strict_types=1);

$result = preg_replace('~x~u', 'y', "\xFF");
$error = preg_last_error();
echo $result === null ? 'Нет результата' : 'Результат есть';
echo '/', $error === PREG_BAD_UTF8_ERROR ? 'bad-utf8' : 'другое', "\n";

Нет результата/bad-utf8

Сохраняйте preg_last_error и preg_last_error_msg немедленно: последующий regex, включая логгер или валидацию сообщения, может сменить состояние. Параметры с & — выходные переменные; не передавайте туда выражение. Неверные flags/типы относятся к PHP API и не обязаны менять last_error. Исключение callback также остаётся исключением. У preg_filter null может быть штатным отсутствием замен, поэтому смотрите его отдельный договор. Для журналов достаточно имени правила, кода, размера входа и обезличенного контекста; полный пользовательский текст часто избыточен.

Все модификаторы и их версии

Буквы после закрывающего разделителя выбирают режим всего шаблона. Они не передаются вместо PHP-flags аргумента. Например i меняет сравнение, а PREG_OFFSET_CAPTURE меняет структуру возвращённых данных. В модификаторах пробел/LF могут игнорироваться, но неизвестная буква даёт warning; писать лишнее оформление не стоит.

<?php
declare(strict_types=1);

echo preg_match('~\AK\z~iu', 'K'), '/', preg_match('~\AK\z~iur', 'K'), "\n";
echo preg_match('~\AГ\z~iur', 'г'), "\n";

1/0
1

<?php
declare(strict_types=1);

preg_match('~(?<code>BR)|(?<code>NT)~J', 'NT', $m);
echo $m['code'], "\n";
echo preg_match('~\ABR41\z~SX', 'BR41'), "\n";

NT
1

Сочетания n/J и группа (?i:...) показаны в разделе групп и локальных настроек. При внешнем PCRE версия PHP сама по себе не гарантирует всякую новую возможность библиотеки. /u — не HTML-sanitizer, /i — не нормализация Unicode, /s — не разрешение опасного регулярного выражения.

Как проверять собственный шаблон на небольших примерах

До применения к файлу импорта составьте маленькую таблицу «ввод → ожидаемое решение». Включите обычный код, пустой ввод, лишний хвост, перевод строки и похожую букву другого алфавита. Это проверяет договор, а не только то, что один удачный пример когда-то прошёл.

<?php
declare(strict_types=1);

$cases = [['BR41', 1], ['BR?', 0], ['', 0], ["BR41\n", 0], ['ВR41', 0]];
foreach ($cases as [$input, $expected]) {
    $actual = preg_match('~\ABR[0-9]+\z~', $input);
    echo $actual === $expected ? 'PASS' : 'FAIL';
    echo "\n";
}

PASS
PASS
PASS
PASS
PASS

<?php
declare(strict_types=1);

function codeForLabel(string $input): ?string
{
    $status = preg_match('~\A(BR|NT)([0-9]{1,4})\z~', $input, $m);
    if ($status === false) { throw new RuntimeException(preg_last_error_msg()); }
    return $status === 1 ? $m[1] . ' / ' . $m[2] : null;
}
echo codeForLabel('BR41') ?? 'Проверьте код', "\n";
echo codeForLabel('XX41') ?? 'Проверьте код', "\n";

BR / 41
Проверьте код

Старая страница PCRE examples полезна как набор форм разделителей, но её вывод о J нужно читать с версией. Отсутствующий разделитель/закрытие и неизвестный модификатор остаются ошибками; пример с /J сегодня допустим. Исходный шаблон, ожидание и результат храните вместе, чтобы изменение требования не свелось к случайному добавлению ?.

Две оболочки: строка PHP и разделители шаблона

Нужно найти путь /catalog/bolts. Кавычки сначала создают строку PHP, затем preg-функция читает внутри неё разделитель ~ и тело правила. Разделитель — один неалфавитно-цифровой байт, не пробел, не обратный слеш и не NUL. Обычно это ~, # или /. Начальные пробелы перед корректным разделителем игнорируются, но яснее их не писать. UTF-8 знак § не подходит: он занимает несколько байтов.

<?php
declare(strict_types=1);

echo preg_match('~/catalog/bolts~i', 'Go to /CATALOG/BOLTS'), "\n";
echo preg_match('/\/catalog\/bolts/i', 'Go to /CATALOG/BOLTS'), "\n";

1
1

<?php
declare(strict_types=1);

$product = 'bolt~large';
$pattern = '~\A' . preg_quote($product, '~') . '\z~';
echo preg_match($pattern, 'bolt~large'), "\n";
echo preg_match('{\ABR[0-9]+\z}', 'BR41'), "\n";

1
1

Допускаются парные (), {}, [], <>; PHP должен корректно найти закрывающий разделитель, а буквальные скобки внутри требуют осторожного экранирования. Для начала выбирайте ~. Даже внутри [...] и \Q...\E разделитель всё ещё обрабатывается PHP. Разделитель отсутствует, не закрыт или после него неизвестная буква — E_WARNING, а не нормальный поиск. Для буквального пользовательского фрагмента используйте preg_quote.

Метасимволы: выбрать один знак или последовательность

Формат артикула BR41 можно описать без перечисления каждого возможного номера. Метасимвол — знак, который задаёт действие в языке шаблона. Остальные символы сравниваются буквально. Положение важно: . вне класса означает любой допустимый знак, а [.] — именно точку. Класс [...] выбирает один знак, группа (...) объединяет целую последовательность.

<?php
declare(strict_types=1);

echo preg_match('~\A[A-Z]{2}[0-9]+\z~', 'BR41'), "\n";
echo preg_match('~\A[A-Z]{2}[0-9]+\z~', 'B41'), "\n";

1
0

<?php
declare(strict_types=1);

echo preg_match('~\Av1.2\z~', 'v1x2'), "\n";
echo preg_match('~\Av1[.]2\z~', 'v1x2'), "\n";
echo preg_match('~\Av1\.2\z~', 'v1.2'), "\n";

1
0
1

Внутри класса метасмысл имеют \, начальный ^, дефис диапазона -, закрывающий ], а [ участвует в специальных POSIX-записях. Все остальные знаки обычно буквальны; PHP-разделитель всё равно нужно экранировать. Вне класса ] и } без парного начала могут быть литералами, но намеренно экранированная пунктуация понятнее. Внешний ? также начинает специальные конструкции после (: (?:...), (?=...) и другие разобраны дальше.

Обратный слеш: PHP сначала, regex потом

Имя папки может содержать \, а строка отчёта — табуляцию. Слеш бывает командой PHP-строки и командой PCRE: эти два уровня нельзя смешивать. В одинарной PHP-строке специально обрабатываются \\ и \'; прочие сочетания вроде \d проходят к regex. Чтобы PCRE получил \\ для буквального слеша, в PHP-коде нужно написать четыре слеша. Nowdoc сохраняет текст без PHP-интерполяции и удобен для длинного правила.

<?php
declare(strict_types=1);

$path = 'save\report';
echo preg_match('~\Asave\\\\report\z~', $path), "\n";
echo bin2hex($path), "\n";

1
736176655c7265706f7274

<?php
declare(strict_types=1);

$line = "BR41\t12\n";
echo preg_replace('~\t~', ' | ', $line);
echo preg_match('~\x{20AC}~u', 'Цена €'), "\n";

BR41 | 12
1

<?php
declare(strict_types=1);

preg_match('~\Q$1.00\E~', 'Price $1.00', $price);
echo $price[0], "\n";
preg_match('~SKU:\K[A-Z]{2}[0-9]+~', 'SKU:BR41', $code, PREG_OFFSET_CAPTURE);
echo $code[0][0], '@', $code[0][1], "\n";

$1.00
BR41@4

Неизвестный escape вроде \q — ошибка в PCRE2. В числовых escapes старые короткие записи неоднозначны: \11 может быть группой 11 либо octal 11. Для ясности выбирайте \g{1} и \o{11}/\x09. В классе \b — backspace 08, снаружи — граница слова. Старые тексты про максимум 99 back references не описывают PCRE2: лимит 99 относится к числовым ссылкам replacement в preg_replace. \K внутри lookaround по умолчанию запрещён с PCRE2 10.38; не переносите туда этот приём. PHP поддерживает NUL в строках; историческое утверждение о NUL как обязательном конце шаблона к современному PHP не относится.

Байты, Unicode properties и видимые знаки

В слове «гайка» буквы должны проверяться как UTF-8, а цену € нельзя измерять одним байтом. В PHP модификатор /u включает UTF и Unicode properties (UCP). Поэтому \d означает Unicode-десятичную цифру, \s Unicode-пробелы, \w включает буквы/числа/соединители и с PCRE2 10.43 также Mn. Для протокола с ASCII-цифрами пишите [0-9]. Без /u строка разбирается побайтно, таблицы некоторых классов могут зависеть от locale. Отдельный (*UTF) в PCRE2 сам по себе не включает UCP; не приравнивайте его к PHP /u.

<?php
declare(strict_types=1);

preg_match('~\p{L}+~u', 'гайка １２', $m);
echo $m[0], "\n";
echo preg_match('~\A\d+\z~u', '１２'), '/', preg_match('~\A[0-9]+\z~', '１２'), "\n";

гайка
1/0

<?php
declare(strict_types=1);

$text = "e\u{0301}Я";
preg_match_all('~. ~ux', $text, $points);
preg_match_all('~\X~u', $text, $clusters);
echo strlen($text), '/', count($points[0]), '/', count($clusters[0]), "\n";
echo bin2hex($clusters[0][0]), "\n";

5/3/2
65cc81

<?php
declare(strict_types=1);

echo preg_match('~\A\p{Cyrillic}+\z~u', 'Гайка'), "\n";
echo preg_match('~\A\p{Lu}\z~iu', 'г'), "\n";
echo preg_match('~\A\p{Lu}\z~iu', 'Г'), "\n";

1
0
1

Каждая code point имеет general category. Однобуквенная L объединяет Ll/Lm/Lo/Lt/Lu; \pL сокращает \p{L}. \P{Lu} и \p{^Lu} — отрицание. Unicode blocks вроде InMusicalSymbols и произвольные Perl properties не поддерживаются. PCRE2 также понимает script/sc/scx, некоторые binary properties и Bidi_Class: сверяйте установленную библиотеку. Cs описывает суррогаты, но допустимый UTF-8 их не содержит. Ни /u, ни \X не нормализуют NFC/NFD: визуально похожие строки могут иметь разные байты. Для нормализации нужен отдельный осознанный шаг intl. Повреждённый UTF-8 приводит к false/PREG_BAD_UTF8_ERROR, а не штатному 0.

Имена письменностей, перечисленные на официальной PHP-странице (не обещание, что это весь более новый Unicode-набор библиотеки): Arabic, Armenian, Avestan, Balinese, Bamum, Batak, Bengali, Bopomofo, Brahmi, Braille, Buginese, Buhid, Canadian_Aboriginal, Carian, Chakma, Cham, Cherokee, Common, Coptic, Cuneiform, Cypriot, Cyrillic, Deseret, Devanagari, Egyptian_Hieroglyphs, Ethiopic, Georgian, Glagolitic, Gothic, Greek, Gujarati, Gurmukhi, Han, Hangul, Hanunoo, Hebrew, Hiragana, Imperial_Aramaic, Inherited, Inscriptional_Pahlavi, Inscriptional_Parthian, Javanese, Kaithi, Kannada, Katakana, Kayah_Li, Kharoshthi, Khmer, Lao, Latin, Lepcha, Limbu, Linear_B, Lisu, Lycian, Lydian, Malayalam, Mandaic, Meetei_Mayek, Meroitic_Cursive, Meroitic_Hieroglyphs, Miao, Mongolian, Myanmar, New_Tai_Lue, Nko, Ogham, Old_Italic, Old_Persian, Old_South_Arabian, Old_Turkic, Ol_Chiki, Oriya, Osmanya, Phags_Pa, Phoenician, Rejang, Runic, Samaritan, Saurashtra, Sharada, Shavian, Sinhala, Sora_Sompeng, Sundanese, Syloti_Nagri, Syriac, Tagalog, Tagbanwa, Tai_Le, Tai_Tham, Tai_Viet, Takri, Tamil, Telugu, Thaana, Thai, Tibetan, Tifinagh, Ugaritic, Vai, Yi. Common объединяет общие знаки, Inherited — наследующие письменность контекста. Пробел/дефис в имени человека обычно нужно разрешить отдельно; список письменностей не является готовой политикой имени. До PCRE8.32 (bundled до PHP5.4.14) \X имел более узкую модель base+marks; современная версия использует extended grapheme cluster. Unicode-таблицы и их стоимость зависят от версии, поэтому не делайте универсальных заявлений «Unicode медленный».

Проверить всю строку, строку отчёта или точный offset

Код заказа не должен принимать скрытый перевод строки на конце. ^ и $ удобны для строк отчёта, но $ по умолчанию разрешает позицию перед последним newline. Для строгого поля используйте \A...\z. Все якоря проверяют позицию: сами символы не поглощают.

<?php
declare(strict_types=1);

$code = "BR41\n";
echo preg_match('~^BR[0-9]+$~', $code), '/', preg_match('~\ABR[0-9]+\z~', $code), "\n";
echo preg_match('~^BR[0-9]+$~D', $code), "\n";

1/0
0

<?php
declare(strict_types=1);

$report = "NT8\nBR41\nNT9";
preg_match_all('~^BR[0-9]+$~m', $report, $m);
echo implode(',', $m[0]), "\n";
echo preg_match('~\ABR[0-9]+\z~m', $report), "\n";

BR41
0

<?php
declare(strict_types=1);

$text = 'x BR41';
echo preg_match('~^BR~', $text, $m, 0, 2), '/', preg_match('~\GBR~', $text, $m, 0, 2), "\n";
echo preg_match('~BR~A', $text, $m, 0, 2), "\n";
echo preg_match('~(?<=x )BR~', $text, $m, 0, 2), "\n";

0/1
1
1

\Z разрешает конец или позицию перед финальным newline независимо от /m; \z — только конец. \b — граница между word/non-word либо соответствующий край строки, \B — её отсутствие. Это не универсальная граница языкового слова: дефис/апостроф и Unicode-модель требуют выбора. У всех альтернатив должно быть нужное ограничение: \A(?:BR|NT)\z, а не \ABR|NT\z. Выбор CR/LF/CRLF разбирается вместе с точкой.

Точка, переводы строк и запрет разрывать UTF-8

Поле заметки может занимать две строки. . без /s пропускает один символ, кроме выбранного newline; /s позволяет ему пройти перевод строки. Это не меняет ^/$ и не влияет на отрицательные классы: [^;] включает newline. В /u точка потребляет одну code point, а не графему.

<?php
declare(strict_types=1);

$note = "A\nB";
echo preg_match('~\AA.B\z~', $note), '/', preg_match('~\AA.B\z~s', $note), "\n";
echo preg_match('~\AA[^;]B\z~', $note), "\n";

0/1
1

<?php
declare(strict_types=1);

$report = "BR41\r\nNT8\n";
$rows = preg_split('~\R~u', $report, -1, PREG_SPLIT_NO_EMPTY);
echo implode('|', $rows), "\n";
echo preg_match('~(*CRLF)^NT8$~m', $report), "\n";

BR41|NT8
0

В начале тела шаблона (*CR), (*LF), (*CRLF), (*ANYCRLF), (*ANY), (*NUL) задают, что считают newline якоря и точка; если несколько — последнее выигрывает. Это отдельно от \R: (*BSR_ANYCRLF) ограничивает его CR/LF/CRLF, (*BSR_UNICODE) допускает Unicode-переводы. \N всегда исключает newline, даже при /s. Старое описание предлагает \C для одного байта внутри UTF-8; это может разорвать кодовую точку. PHP8.5.11 при /u явно запрещает \C (compile warning). Для бинарных байтов используйте byte-mode осознанно, для текста . или \X.

Класс символов и POSIX-наборы

Поле SKU допускает только большие латинские буквы, цифры и дефис. [...] описывает один разрешённый знак; + после класса — несколько. Начальный ^ инвертирует набор, но всё равно потребляет один знак, поэтому [^x] не совпадает с пустой строкой. Диапазоны — диапазоны кодов, не алфавитная сортировка.

<?php
declare(strict_types=1);

echo preg_match('~\A[A-Z0-9-]+\z~', 'BR-41'), "\n";
echo preg_match('~\A[A-Z0-9-]+\z~', 'BR_41'), "\n";

1
0

<?php
declare(strict_types=1);

echo preg_match('~\A[[:xdigit:]]{6}\z~', 'A0ff19'), "\n";
echo preg_match('~\s~', "\x0B"), '/', preg_match('~[[:space:]]~', "\x0B"), "\n";
echo preg_match('~\A[[:alpha:]]+\z~u', 'Гайка'), "\n";

1
1/1
1

Буквальный ] ставят первым элементом либо экранируют; буквальный ^ — не первым либо \^; - — первым/последним либо \-. Диапазон Z-a захватывает пунктуацию между кодами: не заменяет [A-Za-z]. \d и \p{L} можно включать в набор, но свойство не может быть концом диапазона. [^\W_] отбирает word кроме underscore; Unicode-границы всё равно определяет /u. [:^digit:] инвертирует вложенный POSIX-набор, например [[:^digit:]]; голое [:digit:] — не правильная оболочка POSIX. /i учитывает регистр и в положительных/отрицательных классах; /m и /s не меняют принадлежность newline классу.

Альтернативы: порядок и область якорей

Доставка бывает pickup или courier. Вертикальная черта разделяет ветви, а (?:...) объединяет выбор, не создавая отдельного сохранённого поля. Движок пробует слева направо; выбирает первую ветвь, которая позволяет завершить весь шаблон. Пустая ветвь допустима и совпадает с пустым текстом.

<?php
declare(strict_types=1);

$pattern = '~\A(?:pickup|courier)\z~';
echo preg_match($pattern, 'courier'), '/', preg_match($pattern, 'fast-courier'), "\n";

1/0

<?php
declare(strict_types=1);

$pattern = '~\A(?:INV-[0-9]+(*MARK:invoice)|RET-[0-9]+(*:return))\z~';
preg_match($pattern, 'RET-12', $m);
echo $m[0], ':', $m['MARK'], "\n";
preg_match('~BR|BR41~', 'BR41', $short);
echo $short[0], "\n";

RET-12:return
BR

Если продолжение после группы не проходит, движок может вернуться к другой ветви. Метки не обязаны быть уникальными; выбирайте их для понятного отчёта, а не как замену бизнес-проверкам. Для общей части выносите её за группу: BR(?:41|42). Подробнее о запрете возврата — atomic groups.

Настройки внутри шаблона: локальный регистр

Префикс документа может быть нечувствителен к регистру, а секретная часть — чувствительна. (?i:...) включает i только внутри группы; после закрытия скобок прежняя настройка восстанавливается. (?i) без двоеточия меняет оставшуюся часть текущего уровня, а не только следующий символ.

<?php
declare(strict_types=1);

$pattern = '~\A(?i:sku):BR41\z~';
echo preg_match($pattern, 'SKU:BR41'), '/', preg_match($pattern, 'SKU:br41'), "\n";

1/0

<?php
declare(strict_types=1);

echo preg_match('~\A(a(?i)b|c)\z~', 'C'), "\n";
echo preg_match('~\A(?i:tag)(?-i:Q)\z~', 'TAGq'), "\n";

1
0

Доступны i,m,s,x,U,J; n — no-auto-capture (PHP8.2+), r — caseless restrict (PHP8.4+ при подходящей PCRE). (?im-sx) включает im и выключает sx; яснее не повторять одну букву с обеих сторон. (?xx) в PCRE2 дополнительно игнорирует пробел/TAB внутри классов; обычный x этого не делает. (*UTF)/(*UCP) — отдельные глобальные стартовые настройки, не обычные буквы. Старый (?X) больше не поддерживается с PHP7.3; внешний X в PHP8.5.11 принимается как no-op. Все внешние модификаторы и версии.

Группы: сохранить поле, сгруппировать, назвать

Из BR41=12 нужно получить код и количество, а не только ответ да/нет. Обычные (...) сохраняют совпавший текст. Открывающие скобки нумеруются слева направо с 1, [0] всегда всё совпадение. (?:...) только объединяет выражение. (?<sku>...) одновременно даёт понятное имя и обычный номер.

<?php
declare(strict_types=1);

preg_match('~\A(?<sku>[A-Z]{2}[0-9]+)=(?<qty>[0-9]+)\z~', 'BR41=12', $m);
echo $m['sku'], '/', $m['qty'], '/', $m[1], "\n";

BR41/12/BR41

<?php
declare(strict_types=1);

$pattern = '~\A(?|SKU:([A-Z]{2}[0-9]+)|([A-Z]{2}[0-9]+):SKU)\z~';
foreach (['SKU:BR41', 'NT8:SKU'] as $line) {
    preg_match($pattern, $line, $m);
    echo $m[1], "\n";
}

BR41
NT8

<?php
declare(strict_types=1);

$pattern = '~\A(?:(?<sku>BR[0-9]+)|(?<sku>NT[0-9]+))\z~J';
preg_match($pattern, 'NT8', $m);
echo $m['sku'], "\n";
preg_match('~(BR)(?<number>[0-9]+)~n', 'BR41', $named);
echo $named[1], '/', $named['number'], "\n";

NT8
41/41

Другие формы именования — (?P<name>...) и (?'name'...). Для переносимости выбирайте ASCII-имя из букв/цифр/underscore, не начинайте с цифры. В PCRE2 10.44, bundled PHP8.4+, максимальная длина имени 128 вместо прежних 32; внешний PCRE требует проверки версии. Максимум захватывающих групп 65535 не гарантирует, что такой шаблон скомпилируется: есть отдельные ограничения размера и вложенности. Не смешивайте разные имена с одинаковым номером в branch-reset: PCRE2 это отвергает. После branch-reset следующая группа получает номер после максимума всех ветвей; имена — не отдельные «лишние» захваты. preg_match_all объясняет неоднозначность duplicate names при PREG_PATTERN_ORDER.

Повторения: диапазон, жадность и последние значения

Количество в заказе содержит от одной до трёх ASCII-цифр. Квантификатор относится к элементу непосредственно слева: символу, классу, точке, группе или back reference. {1,3} ограничивает длину, но не числовое значение: 000 и 999 одинаково подходят по форме.

<?php
declare(strict_types=1);

$pattern = '~\A[0-9]{1,3}\z~';
echo preg_match($pattern, '12'), '/', preg_match($pattern, '1234'), "\n";
echo preg_match('~\A[0-9]{,3}\z~', '12'), "\n";

1/0
1

<?php
declare(strict_types=1);

$text = '[BR41] [NT8]';
preg_match('~\[.*\]~', $text, $greedy);
preg_match('~\[.*?\]~', $text, $lazy);
preg_match_all('~\[[^\]]*\]~', $text, $bounded);
echo $greedy[0], "\n", $lazy[0], "\n", implode('|', $bounded[0]), "\n";

[BR41] [NT8]
[BR41]
[BR41]|[NT8]

<?php
declare(strict_types=1);

preg_match('~\A([A-Z]{2}[0-9]+,?)+\z~', 'BR41,NT8', $m);
echo $m[1], "\n";
preg_match('~\A(a|(b))+\z~', 'aba', $nested);
echo $nested[1], '/', $nested[2], "\n";

NT8
a/b

Числа в квантификаторах меньше 65536, минимум не больше максимума. {n} — точно n; {n,} — от n; {0} исключает элемент из сопоставления, но не удаляет его определение группы. Неправильные фигурные записи могут стать литералами либо ошибкой по контексту; буквальные скобки экранируйте. PCRE2 10.43+ допускает пробел/TAB вокруг чисел и запятой в { 1 , 3 }; старые версии — нет. Под /U жадность меняется местами, а ? после квантификатора снова её переворачивает. *+ и ++ запрещают возврат: это отдельная семантика, а не универсальная оптимизация. Пустая повторяемая группа не зацикливает движок бесконечно: нулевой прогресс обрабатывается специально. Большой конечный repeat группы увеличивает compiled pattern, поэтому лимит количества не заменяет оценку памяти. Начальное .* с /s часто допускает implicit anchoring, но исключения (backrefs/atomic/control verbs) не позволяют полагаться на это как на правило валидации.

Back reference: повторить именно найденный текст

Метка товара записана дважды для контрольного подтверждения: BR41/BR41. Back reference сравнивает с конкретным ранее захваченным текстом. Повторное написание того же шаблона лишь проверило бы форму и допустило BR41/NT8.

<?php
declare(strict_types=1);

$pattern = '~\A(?<code>[A-Z]{2}[0-9]+)/\k<code>\z~';
echo preg_match($pattern, 'BR41/BR41'), '/', preg_match($pattern, 'BR41/NT8'), "\n";

1/0

<?php
declare(strict_types=1);

echo preg_match('~\A(BR)(41):\g{-1}:\g{1}2\z~', 'BR41:41:BR2'), "\n";
echo preg_match('~\A((?i)br)\s+\1\z~', 'BR br'), "\n";

1
0

Числовые формы \1, \g1, \g{1} эквивалентны при правильном номере; относительные -1/-2 упрощают перемещение фрагмента. Формы имени: \k<name>, \k'name', \k{name}, \g{name}, (?P=name). Важное уточнение старой PHP-страницы: \g<name> и \g'name' в PCRE2 — subroutine calls, а не ссылки на тот же захваченный текст; это разобрано в рекурсии. Не участвовавшая группа заставляет ссылку провалиться; пустая участвовавшая группа — другой случай. Внутренняя ссылка на текущую группу на первой итерации ещё не имеет значения, но может использовать предыдущее значение на повторе. Forward references бывают полезны только при корректной структуре повторов; не используйте их для обычного поля. Внутри [...] цифровой escape обозначает символ, не back reference. Не переносите syntax pattern \g{1} в replacement: там другой язык $1/${1}.