Сравнение производительности 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
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
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
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, если они включены.
Чек-лист перед выбором функции
- Для одной точной подстроки начните со
str_replace(). Для нескольких правил проверьте, должны ли поздние замены менять ранее вставленные значения. - Для словаря плейсхолдеров возьмите
strtr($text, $map), если вставки должны оставаться цельными. Добавьте пример с перекрывающимися ключами, если они встречаются в словаре. - Для совпадений по форме используйте
preg_replace(), обработайтеnullи проверьте смысл$1в строке замены. Для буквального динамического значения используйте колбэк. - Сверьте результаты на одинаковых входах. Включите пустую строку, отсутствие совпадений, повторяющиеся ключи во входе и реальные многобайтные данные.
- Если замена видна в профиле приложения, замерьте весь сценарий с характерными аргументами. При близких временах выбирайте функцию, которая прямо выражает нужный порядок и правила замены.
Частые вопросы
Что быстрее в PHP 8: strtr или str_replace?
Для одной буквальной подстроки начните со str_replace. Для словаря сравните обе функции на своих данных после проверки результата. Размер словаря, длина строк и число совпадений влияют на итог замера.
Как заменить несколько тегов, сохранив теги внутри вставляемых значений?
Передайте в strtr исходную строку и ассоциативный массив замен. Функция продолжит поиск в исходной строке после совпадения и оставит вставленное значение целиком.
Когда имеет смысл использовать preg_replace вместо буквальной замены?
Когда фрагмент определяется шаблоном, например последовательностью пробелов, группой цифр или набором вариантов с общим форматом. Если строка замены должна вставляться буквально, используйте preg_replace_callback и верните значение из колбэка.