Строки в PHP: длина, поиск, замена и обрезка
Строка в PHP хранит байты, поэтому длина текста и смещение в нём зависят от выбранной функции. Разберём, как искать, вырезать и заменять подстроки, обрабатывать кириллицу и приводить переносы к нужному формату.
Длина строки в PHP: strlen, mb_strlen и grapheme_strlen
strlen() возвращает длину строки в байтах. Используйте её для проверки размера бинарных данных, расчёта байтовых смещений и соблюдения лимита, заданного в байтах. Символ NUL внутри строки тоже занимает один байт и учитывается при подсчёте.
Для текста UTF-8 mb_strlen() считает кодовые точки. Если ограничение задано в знаках, которые видит пользователь, используйте grapheme_strlen(). Например, буква с комбинируемым ударением может состоять из двух кодовых точек и при этом образовывать один графемный кластер.
<?php
declare(strict_types=1);
$text = 'Привет';
echo strlen($text), "\n"; // 12 байтов в UTF-8
echo mb_strlen($text, 'UTF-8'), "\n"; // 6 кодовых точек
$letter = "е\u{0301}"; // Буква е и знак ударения
echo mb_strlen($letter, 'UTF-8'), "\n"; // 2 кодовые точки
echo grapheme_strlen($letter), "\n"; // 1 графемный кластерСохраните файл с примером в UTF-8. Функции mb_* требуют расширения mbstring, функции grapheme_* — расширения intl. Явная кодировка в вызовах mb_* убирает зависимость от внутренней настройки PHP. Если текст приходит из файла или внешнего API и его кодировка неизвестна, проверьте входные данные перед обработкой, например через mb_check_encoding($text, 'UTF-8'). grapheme_strlen() ожидает корректный UTF-8 и при ошибке может вернуть false или null.
Подстрока в строке PHP: str_contains и strpos
Когда нужно установить наличие подстроки, используйте str_contains(). Чтобы получить позицию первого совпадения, вызовите strpos(). Функция возвращает байтовое смещение с начала строки или false, если совпадения нет. Позиция первого байта равна 0, поэтому результат проверяйте через !== false.
<?php
$text = 'PHP: строки';
if (str_contains($text, 'строки')) {
echo "Подстрока найдена\n";
}
$position = strpos($text, 'PHP');
if ($position !== false) {
echo $position, "\n"; // 0 — совпадение в начале строки
}
echo strpos($text, 'строки', 4), "\n"; // 5 — смещение в байтахТретий аргумент strpos() задаёт смещение, с которого начинается поиск. Возвращаемая позиция по-прежнему отсчитывается от начала строки. Отрицательное смещение задаёт точку начала поиска относительно конца строки. Для поиска последнего совпадения используйте strrpos(). Если интересует только начало или конец строки, подойдут str_starts_with() и str_ends_with().
Поиск без учёта регистра и смещения в UTF-8
stripos() подходит для поиска без учёта регистра в ASCII. Начиная с PHP 8.2 такое сравнение выполняется независимо от локали. Для кириллицы используйте mb_stripos(), а для поиска с учётом регистра и получения позиции в кодовых точках — mb_strpos().
<?php
$text = 'Курс PHP';
echo strpos($text, 'PHP'), "\n"; // 9 байтов
echo mb_strpos($text, 'PHP', 0, 'UTF-8'), "\n"; // 5 кодовых точек
var_dump(mb_stripos($text, 'курс', 0, 'UTF-8')); // int(0)Типичная ошибка в фильтре — принять пустой запрос за обычное условие поиска. В PHP 8.x str_contains($text, '') возвращает true, а strpos($text, '') при смещении по умолчанию возвращает 0. Если пустой запрос должен отключать фильтр или вызывать ошибку ввода, обработайте его явно.
Как вырезать подстроку в PHP: substr и mb_substr
substr($text, $offset, $length) вырезает фрагмент по байтовым смещениям. Отрицательный $offset отсчитывается от конца. Без $length или при значении null функция берёт остаток строки. Отрицательная длина исключает указанное число байтов с конца строки.
<?php
$code = 'INV-2026-0042';
echo substr($code, 4, 4), "\n"; // 2026
echo substr($code, -4), "\n"; // 0042
echo substr($code, 0, -5), "\n"; // INV-2026При разборе текста держите поиск и извлечение в одних единицах. Позицию из strpos() передавайте в substr(). Позицию из mb_strpos() передавайте в mb_substr() с той же кодировкой. Для обрезки пользовательского текста с сохранением целых графемных кластеров используйте grapheme_substr() на корректном UTF-8.
<?php
$text = 'Раздел: строки';
$separator = mb_strpos($text, ':', 0, 'UTF-8');
if ($separator !== false) {
$value = mb_substr($text, $separator + 1, null, 'UTF-8');
echo trim($value), "\n"; // строки
}В PHP 8.x вызов substr('abc', 10) возвращает пустую строку. Такой же результат даёт substr('abc', 0, 0). Если для вашей задачи важно различать недопустимое смещение и допустимый пустой фрагмент, сначала проверьте границы. При обрезке UTF-8 обычный substr() может разрезать многобайтовый символ посередине и вернуть некорректный UTF-8.
Замена в PHP: str_replace и удаление из строки
str_replace($search, $replace, $subject) заменяет все буквальные совпадения с учётом регистра. Для поиска и замены можно передать массивы. Четвёртый аргумент получает число выполненных замен. Чтобы удалить подстроку, передайте пустую строку в качестве замены.
<?php
$line = ' код: A-42; код: B-17 ';
$result = str_replace('код: ', '', $line, $count);
echo trim($result), "\n"; // A-42; B-17
echo $count, "\n"; // 2
$sku = str_replace([' ', '-'], '', 'AB - 123');
echo $sku, "\n"; // AB123При поиске PHP replace обычно нужна str_replace(). Для буквальной замены целых фрагментов UTF-8 используйте строки в одной кодировке. Регистр и Unicode-нормализация влияют на совпадения: составная буква и визуально такая же буква из одной кодовой точки имеют разное байтовое представление. str_ireplace() выполняет сравнение без учёта регистра для ASCII. Когда требуется регистронезависимая замена кириллицы или поиск по шаблону, используйте preg_replace() с подходящими флагами, например iu для шаблона UTF-8 без учёта регистра.
Порядок замен и удаление одного фрагмента
При передаче массива в str_replace() правила применяются последовательно. Вызов str_replace(['a', 'b'], ['b', 'c'], 'a') вернёт 'c': результат первого правила попадёт под второе. Для буквальных замен по словарю без повторной обработки вставленного текста подходит strtr($text, $map). Если несколько ключей подходят в одной позиции, этот вариант strtr() сначала пробует самый длинный.
Чтобы удалить только первое совпадение, найдите его через strpos() и замените нужный диапазон через substr_replace(). Аргумент длины для substr_replace() задаётся в байтах, поэтому для найденной подстроки берите strlen().
<?php
$text = 'метка: A, метка: B';
$needle = 'метка: ';
$offset = strpos($text, $needle);
if ($offset !== false) {
$text = substr_replace($text, '', $offset, strlen($needle));
}
echo $text, "\n"; // A, метка: BОбрезка пробелов и краёв строки: trim в PHP
trim() удаляет символы с обоих краёв строки, ltrim() — с начала, rtrim() — с конца. По умолчанию в набор входят обычный пробел, табуляция, LF, CR, вертикальная табуляция и NUL. Пробелы и переносы внутри строки сохраняются.
<?php
$text = "\t два слова \r\n";
echo trim($text), "\n"; // два слова
$line = "ответ с пробелами \r\n";
echo strlen(rtrim($line, "\r\n")), "\n"; // 36 байтов, два пробела сохраненыВторой аргумент trim() задаёт набор отдельных байтов. Например, trim('report.tar', '.tar') вернёт 'epo', потому что убирает с краёв каждый байт из набора ., t, a, r. Для снятия точного суффикса сначала проверьте его через str_ends_with().
<?php
$file = 'report.tar';
$suffix = '.tar';
if ($suffix !== '' && str_ends_with($file, $suffix)) {
$file = substr($file, 0, -strlen($suffix));
}
echo $file, "\n"; // reportНеразрывный пробел и другие пробельные символы Unicode требуют отдельной обработки. В PHP 8.4 и 8.5 для многобайтового текста доступны mb_trim(), mb_ltrim() и mb_rtrim(). Если тот же код должен работать в PHP 8.3, можно явно задать набор краевых символов в регулярном выражении. Например, следующий шаблон обрезает Unicode-разделители категории Z и управляющие символы U+0009–U+000D, включая табуляцию и переносы.
<?php
$text = "\u{00A0} два слова \u{00A0}";
$result = preg_replace('/\A[\p{Z}\x09-\x0D]+|[\p{Z}\x09-\x0D]+\z/u', '', $text);
if ($result === null) {
throw new RuntimeException('Не удалось обработать строку UTF-8');
}
echo $result, "\n"; // два словаПеренос строки в PHP: LF, CRLF и PHP_EOL
В двойных кавычках "\n" означает LF, а "\r\n" — CRLF. В одинарных кавычках '\n' содержит обратную косую черту и букву n. Константа PHP_EOL возвращает окончание строки платформы, где работает PHP. Обычно это LF на Unix-подобных системах и CRLF на Windows.
PHP_EOL подходит для локального текстового вывода, когда нужен формат платформы запуска. Если файл или протокол требует конкретного окончания строки, задайте его явно. При чтении текста с разных платформ сначала приведите CRLF и одиночный CR к LF, затем делите по "\n". Порядок важен: если сначала заменить CR, исходный CRLF превратится в два LF.
<?php
$input = "первая\r\nвторая\rтретья\n";
$normalized = str_replace(["\r\n", "\r"], "\n", $input);
$lines = explode("\n", $normalized);
// Последний LF даёт пустой элемент в конце массива.
if (str_ends_with($normalized, "\n")) {
array_pop($lines);
}
echo implode(PHP_EOL, $lines), PHP_EOL;В примере убирается ровно один пустой элемент, появившийся из-за завершающего переноса. Пустые строки внутри текста сохраняются. В HTML обычный перенос в исходном тексте при стандартном отображении пробелов схлопывается. Если пользовательский текст должен показываться с разрывами строк, сначала экранируйте его через htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), затем примените nl2br().
PHP 8.3–8.5: совместимость и чек-лист
str_contains(), str_starts_with() и str_ends_with() доступны с PHP 8.0 и работают во всех трёх версиях. Для кода с минимальной версией PHP 8.3 учитывайте, что семейство mb_trim() появилось в 8.4. С PHP 8.1 передача null во встроенную функцию с обязательным строковым параметром при приведении типов устарела. В строгом режиме такой вызов, например trim(null), приводит к TypeError. Если поле допускает null, решите на входе, означает ли это отсутствие значения или пустую строку.
- Длина. Байты считайте через
strlen(), кодовые точки черезmb_strlen(), графемные кластеры черезgrapheme_strlen(). - Поиск. Для ответа «есть ли подстрока» берите
str_contains(). Позицию изstrpos()илиmb_strpos()проверяйте через!== false. - Извлечение. Передавайте байтовые смещения в
substr(), а смещения в кодовых точках — вmb_substr(). - Замена. Используйте
str_replace()для всех буквальных совпадений, пустую замену для удаления иsubstr_replace()для одного найденного диапазона. - Края и переносы. Для точного префикса или суффикса используйте проверку на совпадение и срез. Выбирайте между
PHP_EOL, LF и CRLF по требованиям получателя.
Частые вопросы
Почему strlen в PHP возвращает 12 для строки «Привет»?
strlen() считает байты. В UTF-8 каждая из шести букв этого слова занимает два байта. Для подсчёта кодовых точек используйте mb_strlen($text, 'UTF-8').
Как проверить, есть ли подстрока в строке PHP?
Используйте str_contains($text, $needle). Если нужна позиция, вызовите strpos() и проверьте результат через !== false. Значение 0 означает совпадение в начале строки.
Как удалить переносы строк из строки в PHP?
Вызовите str_replace() с массивом из CRLF, LF и CR и пустой строкой в качестве замены. Поставьте CRLF первым. Если слова на соседних строках должны остаться разделёнными, замените переносы пробелом.