PHPTime

Строки в PHP: длина, поиск, замена и обрезка

Строка в PHP хранит байты, поэтому длина текста и смещение в нём зависят от выбранной функции. Разберём, как искать, вырезать и заменять подстроки, обрабатывать кириллицу и приводить переносы к нужному формату.

Длина строки в PHP: strlen, mb_strlen и grapheme_strlen

strlen() возвращает длину строки в байтах. Используйте её для проверки размера бинарных данных, расчёта байтовых смещений и соблюдения лимита, заданного в байтах. Символ NUL внутри строки тоже занимает один байт и учитывается при подсчёте.

Для текста UTF-8 mb_strlen() считает кодовые точки. Если ограничение задано в знаках, которые видит пользователь, используйте grapheme_strlen(). Например, буква с комбинируемым ударением может состоять из двух кодовых точек и при этом образовывать один графемный кластер.

PHP
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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 первым. Если слова на соседних строках должны остаться разделёнными, замените переносы пробелом.

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

Ещё в разделе «Справочник PHP»

Типы данных и преобразование типов в PHP

Типы данных в PHP 8.3–8.5: как узнать тип переменной, преобразовать строку в число, проверить null через isset и empty, разделить и округлить числа.

10 мин

Функции в PHP: аргументы, типы, замыкания и стрелочные функции

Практическая справка по функциям PHP 8.3–8.5: аргументы, типы и return, область видимости, global и static, замыкания use и стрелочные функции fn.

10 мин

Хеширование паролей в PHP: password_hash, password_verify, md5 и hash

Как хешировать и проверять пароли в PHP 8.3–8.5, обновлять старые хеши при входе и выбирать между password_hash(), md5(), hash() и hash_hmac() для разных задач.

9 мин

Циклы в PHP: for, while, do-while и foreach

Как работают циклы for, while, do-while и foreach в PHP 8.3–8.5. Примеры обхода массивов, вложенных циклов и применения break и continue.

10 мин