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

<?php
declare(strict_types=1);

$status = preg_match('~\AORD-([0-9]+)\z~', 'ORD-104', $matches);
if ($status === 1) { echo 'Номер: ', $matches[1], "\n"; }

Номер: 104

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

<?php
declare(strict_types=1);

function orderNumber(string $code): ?string
{
    $result = preg_match('~\AORD-(?<number>[0-9]+)\z~', $code, $m);
    if ($result === false) { throw new RuntimeException(preg_last_error_msg()); }
    return $result === 1 ? $m['number'] : null;
}
echo orderNumber('ORD-007'), "\n";
echo orderNumber('ORD-7x') ?? 'Исправьте код', "\n";

007
Исправьте код

function объявляет повторно используемое действие; ?string означает строку или null. Оператор ?? подставляет сообщение только для null. Ошибка движка не становится сообщением «плохой код».

<?php
declare(strict_types=1);

preg_match('~(?<code>BR[0-9]+)(?:-(?<size>[0-9]+))?~u', 'Я BR41', $m,
    PREG_OFFSET_CAPTURE | PREG_UNMATCHED_AS_NULL);
echo $m['code'][0], '@', $m['code'][1], "\n";
echo $m['size'][0] === null ? 'size:null' : 'size:set';
echo '@', $m['size'][1], "\n";

BR41@3
size:null@-1

Я занимает 2 байта, затем пробел: BR41 начинается с байта 3. (?:...) группирует без отдельного результата; ? делает суффикс необязательным. Эти формы подробно разобраны в синтаксисе главы.

<?php
declare(strict_types=1);

$raw = '25';
$ok = preg_match('/\A[1-9][0-9]{0,2}\z/', $raw);
echo $ok === 1 ? "1..999\n" : "Неверно\n";

1..999

Тип raw должен быть проверен до этого фрагмента. Ограниченная длина не позволит переполнить int при последующем приведении.

<?php
declare(strict_types=1);

$result = preg_match('/\Aorder:(?<id>[1-9][0-9]*)\z/', 'order:2048', $matches);
if ($result !== 1) {
    throw new UnexpectedValueException('Не ссылка заказа');
}
echo $matches['id'], "\n";

2048

Группа возвращается строкой. Перед int добавьте допустимый предел; проверка формата не заменяет права доступа к заказу.

<?php
declare(strict_types=1);

$clean = preg_replace('~[ \t]+~', ' ', 'Bolt   M10', -1, $count);
echo $clean, "\n", 'Замен: ', $count, "\n";

Bolt M10
Замен: 1

Количество замен — число совпадений, не число удалённых байтов. Эта версия сохраняет переводы строк.

<?php
declare(strict_types=1);

$label = preg_replace('~\A([A-Z]{2})([0-9]+)\z~', '$1 / ${2}0', 'BR41');
echo $label, "\n";

BR / 410

Группа 2 содержит 41; ${2}0 добавляет буквальный 0. Это форматирование, не умножение числа. $name по имени в replacement не поддерживается: для имён применяйте callback.

<?php
declare(strict_types=1);

$result = preg_replace(['~old~', '~new~'], ['new', 'ready'],
    ['a' => 'old old', 'b' => 'old'], 1, $count);
foreach ($result as $key => $value) { echo $key, ':', $value, "\n"; }
echo 'Замен: ', $count, "\n";

a:ready old
b:ready
Замен: 4

Сначала old становится new, затем new становится ready. limit=1 действует отдельно на каждую пару шаблон/строка, count суммирует четыре операции.

<?php
declare(strict_types=1);

$result = preg_replace('/\s+/u', ' ', "Чай\t зеленый");
if ($result === null) {
    throw new RuntimeException(preg_last_error_msg());
}
echo $result, "\n";

Чай зеленый

Нормализация подходит для однострочного поля. Не применяйте к отзыву с абзацами без решения, что переносы незначимы.

<?php
declare(strict_types=1);

$line = 'pin=123456 status=sent';
$safe = preg_replace('/\bpin=[0-9]{6}\b/', 'pin=[hidden]', $line, 1, $count);
if ($safe === null) {
    throw new RuntimeException('Ошибка шаблона');
}
echo $safe, ':', $count, "\n";

pin=[hidden] status=sent:1

Лучше изначально не писать секрет в журнал. Это ограниченный пример известного формата, а не универсальный редактор персональных данных.

<?php
declare(strict_types=1);

$tags = preg_split('~[,;\s]+~u', ' гайки, болты; шайбы ', -1, PREG_SPLIT_NO_EMPTY);
echo implode(' / ', $tags), "\n";

гайки / болты / шайбы

/u — UTF-8 и Unicode-пробелы; запятая внутри самого тега этим форматом не допускается. Для CSV с кавычками нужен CSV-парсер.

<?php
declare(strict_types=1);

$parts = preg_split('~\s*=\s*~', 'title = Bolt = M10', 2);
echo $parts[0], "\n", $parts[1], "\n";

title
Bolt = M10

limit 2 запрещает дальнейшее деление после первого разделителя; второе = остаётся частью значения.

<?php
declare(strict_types=1);

$parts = preg_split('~([+\-])~', '12+5-2', -1,
    PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_OFFSET_CAPTURE);
foreach ($parts as [$text, $offset]) { echo $text, '@', $offset, "\n"; }

12@0
+@2
5@3
-@4
2@5

Скобки захватывают знак, поэтому он не теряется. Это только токены калькулятора, ещё не вычисление и не разрешение выполнять ввод как PHP.

<?php
declare(strict_types=1);

$parts = preg_split('/\s*[,;]\s*/u', 'php, api; shop', -1, PREG_SPLIT_NO_EMPTY);
if ($parts === false) {
    throw new RuntimeException('Не разделить строку');
}
echo implode('|', $parts), "\n";

php|api|shop

Формат явно разрешает два разделителя. Если сам тег может содержать запятую, нужен структурный формат или экранирование с настоящим парсером.

<?php
declare(strict_types=1);

$words = preg_split('/\s+/u', trim('  чай   зеленый '), -1, PREG_SPLIT_NO_EMPTY);
if ($words === false) {
    throw new RuntimeException('Неверный текст');
}
echo count($words), ':', implode(',', $words), "\n";

2:чай,зеленый

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