PHPTime

Сравнение производительности strtr, str_replace и preg_replace в PHP

Для буквальной замены начните со str_replace, для подстановки по словарю рассмотрите strtr, а для поиска по шаблону используйте preg_replace. На PHP 8.3–8.5 скорость зависит от входных данных и числа правил. Сравнивать время имеет смысл после того, как все варианты выдают одинаковый результат.

Какую функцию выбрать для конкретной замены

При замене одного известного фрагмента str_replace() — естественная отправная точка. Для словаря плейсхолдеров полезна двухаргументная форма strtr(). Она отдаёт приоритет длинному ключу и пропускает уже вставленный текст. preg_replace() нужна, когда совпадение описано правилом, например последовательностью пробельных символов или группой цифр.

ЗадачаФункцияПоведение
Заменить буквальную подстроку или применить цепочку правилstr_replace()Каждое следующее правило видит результат предыдущего
Подставить значения по словарю за один проход по входуstrtr($text, $map)При совпадении в одной позиции выбирает самый длинный ключ
Заменить отдельные байты по таблицеstrtr($text, $from, $to)Сопоставляет байты по их позициям в двух строках
Найти фрагмент по регулярному выражениюpreg_replace()Поддерживает группы захвата, обратные ссылки и лимит замен

str_replace и strtr дают разные результаты

Массивы поиска и замены в str_replace() задают порядок обработки. Если первое правило вставляет подстроку, которую ищет второе, второе изменит и вставленный текст. В strtr() со словарём подстановка завершается на найденном фрагменте. Поиск продолжается дальше по исходной строке.

PHP
<?php
declare(strict_types=1);

$template = '{name} — {role}';
$map = ['{name}' => 'Автор {role}', '{role}' => 'редактор'];

echo str_replace(array_keys($map), array_values($map), $template);
// Автор редактор — редактор

echo strtr($template, $map);
// Автор {role} — редактор

Перекрывающиеся ключи тоже влияют на результат. Вызов strtr('foobar', ['foo' => 'X', 'foobar' => 'Y']) вернёт Y. При последовательности ['foo', 'foobar'] с заменами ['X', 'Y'] функция str_replace() сначала получит Xbar, после чего второй ключ уже не совпадёт. Если нужны именно последовательные преобразования, порядок правил стоит закрепить тестом.

Трёхаргументная форма strtr() подходит, например, для замены + и / на - и _ в ASCII-строке. Она работает с байтами, поэтому для замены русских букв используйте словарь полных UTF-8-последовательностей. Буквальная замена через словарь или str_replace() ищет точные последовательности байтов. Канонически эквивалентные строки в разных формах Unicode могут потребовать предварительной нормализации.

Где оправдана регулярка

Выражение полезно, когда заранее известна форма совпадения, а его содержание меняется. Например, можно свести серию пробелов и табуляций к одному пробелу. В этом примере класс символов явно ограничен ASCII-пробелом и табуляцией, поэтому границы строк сохраняются.

PHP
<?php
declare(strict_types=1);

function collapseHorizontalSpace(string $text): string
{
    // Заменяем только серии ASCII-пробелов и табуляций.
    return preg_replace('/[ \t]+/', ' ', $text)
        ?? throw new RuntimeException(preg_last_error_msg());
}

echo collapseHorizontalSpace("PHP\t  8"); // PHP 8

Проверяйте null отдельно от пустой строки. Пустая строка может быть корректным ответом после удаления совпадений, а null означает ошибку. Модификатор u включайте, когда шаблону нужна семантика UTF-8. При этом некорректный UTF-8 во входных данных может привести к ошибке.

Строка замены в preg_replace() интерпретируется по своим правилам. Например, $1 подставляет содержимое первой группы захвата. Если шаблон нужен для поиска, а значение замены приходит извне и должно вставиться буквально, возвращайте его из колбэка preg_replace_callback(). Для обычной буквальной замены проще сразу взять str_replace().

Что меняет производительность в PHP 8.3–8.5

  • Длина входа и плотность совпадений. На коротком тексте заметна стоимость вызова. Когда совпадений много, растёт вклад формирования результата, особенно если вставки существенно длиннее найденных фрагментов.
  • Количество и форма правил. В str_replace() набор правил означает последовательные поиски. Для strtr() со словарём важны состав ключей и их пересечения. Прогоняйте реальные ключи и характерные строки, включая вход без совпадений.
  • Подготовка аргументов. Если вы вызываете array_keys() и array_values() для каждого сообщения, это часть стоимости обработки. Если массивы готовятся один раз и переиспользуются, вынесите их из замера.
  • Сложность регулярки и повторное использование. PHP кеширует скомпилированные выражения. Повторение одного короткого паттерна и генерация нового паттерна на каждой итерации дают разные нагрузки. Зафиксируйте также настройку pcre.jit.

Один короткий шаблон с двумя плейсхолдерами даёт ответ только для этого сценария. Чтобы оценить рабочую нагрузку, повторите замер отдельно на коротких и длинных строках, на малом и большом словаре, с типичной плотностью совпадений. Если код работает в PHP-FPM, после прогона в CLI проверьте эффект на запросе с рабочей конфигурацией и входными данными приложения.

Воспроизводимый бенчмарк с одинаковым результатом

В примере все варианты меняют оба плейсхолдера и возвращают одну строку. У регулярного выражения два правила в одном вызове preg_replace(). Такое сравнение учитывает полную операцию. Замер одной регулярной замены против двух буквальных подстановок ответил бы на другой вопрос.

PHP
<?php
declare(strict_types=1);

$text = 'Шаблон {tag1} содержит {tag1} и {tag2}.';
$expected = 'Шаблон PHP содержит PHP и PCRE.';
$map = ['{tag1}' => 'PHP', '{tag2}' => 'PCRE'];
$keys = array_keys($map);
$values = array_values($map);
$patterns = ['~\{tag1\}~', '~\{tag2\}~'];

$cases = [
    'str_replace' => static fn (): string => str_replace($keys, $values, $text),
    'strtr' => static fn (): string => strtr($text, $map),
    'preg_replace' => static fn (): string => preg_replace($patterns, $values, $text)
        ?? throw new RuntimeException(preg_last_error_msg()),
];

printf("PHP %s, %s, PCRE JIT=%s\n", PHP_VERSION, PHP_SAPI, ini_get('pcre.jit'));

// Проверяем результат и прогреваем каждый вариант до замеров.
foreach ($cases as $name => $replace) {
    if ($replace() !== $expected) {
        throw new RuntimeException("Неверный результат у $name");
    }
    for ($i = 0; $i < 2_000; ++$i) {
        $replace();
    }
}

$iterations = 100_000;
$samples = [];
$names = array_keys($cases);

for ($round = 0; $round < 9; ++$round) {
    // Каждый вариант одинаковое число раз идёт первым, вторым и третьим.
    foreach ($names as $index => $name) {
        $name = $names[($index + $round) % count($names)];
        $replace = $cases[$name];
        $start = hrtime(true);
        for ($i = 0; $i < $iterations; ++$i) {
            $last = $replace();
        }
        $elapsed = hrtime(true) - $start;
        if ($last !== $expected) {
            throw new RuntimeException("Неверный результат у $name");
        }
        $samples[$name][] = $elapsed / $iterations;
    }
}

foreach ($samples as $name => $times) {
    sort($times, SORT_NUMERIC);
    $median = $times[intdiv(count($times), 2)];
    printf("%s: %.1f нс/операцию, диапазон %.1f–%.1f\n",
        $name, $median, $times[0], $times[count($times) - 1]);
}

Запустите файл через php bench.php. hrtime(true) использует монотонный таймер, а медиана сглаживает влияние единичных скачков. В число входят цикл и вызов замыкания, общие для всех вариантов. При близких медианах и заметном разбросе повторите весь прогон и посмотрите, сохраняется ли порядок. Сохраняйте вместе с результатом параметры входа, версию PHP и настройки CLI, включая OPcache и JIT, если они включены.

Чек-лист перед выбором функции

  1. Для одной точной подстроки начните со str_replace(). Для нескольких правил проверьте, должны ли поздние замены менять ранее вставленные значения.
  2. Для словаря плейсхолдеров возьмите strtr($text, $map), если вставки должны оставаться цельными. Добавьте пример с перекрывающимися ключами, если они встречаются в словаре.
  3. Для совпадений по форме используйте preg_replace(), обработайте null и проверьте смысл $1 в строке замены. Для буквального динамического значения используйте колбэк.
  4. Сверьте результаты на одинаковых входах. Включите пустую строку, отсутствие совпадений, повторяющиеся ключи во входе и реальные многобайтные данные.
  5. Если замена видна в профиле приложения, замерьте весь сценарий с характерными аргументами. При близких временах выбирайте функцию, которая прямо выражает нужный порядок и правила замены.

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

Что быстрее в PHP 8: strtr или str_replace?

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

Как заменить несколько тегов, сохранив теги внутри вставляемых значений?

Передайте в strtr исходную строку и ассоциативный массив замен. Функция продолжит поиск в исходной строке после совпадения и оставит вставленное значение целиком.

Когда имеет смысл использовать preg_replace вместо буквальной замены?

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

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

Ещё в разделе «Производительность»

Часовые пояса в PHP: как хранить и преобразовывать время

Как работать с часовыми поясами в PHP 8.3–8.5: хранить события в UTC, настраивать MySQL, переводить время для пользователя и учитывать переходы на летнее время.

8 мин

Почему Nginx + PHP-FPM может быть быстрее Apache + mod_php

Разбираем, когда Nginx и PHP-FPM быстрее Apache с mod_php, как на результат влияют MPM, .htaccess и OPcache и как измерить разницу на своём проекте.

6 мин

Как быстрее обойти массив в PHP без ключей

Как быстро обойти значения массива в PHP 8.3–8.5: когда выбрать foreach, где нужен индекс и как измерить скорость циклов без влияния вывода.

8 мин

Как быстрее обойти массив без ключей в PHP

Как обойти массив без ключей в PHP 8.3–8.5. Сравниваем foreach, array_walk, iterator_apply и for, разбираем остановку обхода и замеряем скорость без вывода.

8 мин