PHP substr(): получить часть строки

substr($string, $offset, $length) возвращает часть $string, которая начинается с позиции $offset (отсчёт с 0) и имеет длину $length символов. substr('Hello world', 0, 5) возвращает "Hello". Не указывайте $length, чтобы взять всё до конца.

<?php
$s = 'Hello world';

echo substr($s, 0, 5), "\n";   // from the start, 5 characters
echo substr($s, 6), "\n";      // from position 6 to the end
echo substr($s, 4, 3), "\n";   // 3 characters from position 4

substr() считает байты. Для английского текста это то же самое, что символы, но не для кириллицы, японского, китайского, эмодзи или букв с диакритикой. Для них используйте mb_substr(), она показана ниже.

Синтаксис

substr(string $string, int $offset, ?int $length = null): string

• $offset задаёт, откуда начинать. 0 это первый символ. Отрицательное значение отсчитывается с конца.
• $length задаёт, сколько байтов взять (в обычном ASCII-тексте один байт это один символ). Отрицательное значение отбрасывает столько же с конца. null (или отсутствие аргумента) означает "до конца".

Отрицательные смещение и длина: работа с конца

Отрицательный $offset начинает отсчёт с конца строки, поэтому -1 это последний символ. Отрицательная $length останавливается за столько символов до конца.

<?php
$file = 'report-2026.pdf';

echo substr($file, -3), "\n";       // last 3 characters
echo substr($file, -8, 4), "\n";    // 4 characters, starting 8 from the end
echo substr($file, 0, -4), "\n";    // everything except the last 4
echo substr($file, 7, -4), "\n";    // from position 7, minus the last 4

substr($s, 0, -1) это обычный способ удалить последний символ, например запятую в конце, оставленную циклом.

Первый или последний символ

Для одного байта можно обратиться к строке и по индексу. $s[0] это первый символ, а начиная с PHP 7.1 $s[-1] это последний.

<?php
$word = 'banana';

echo substr($word, 0, 1), ' ', $word[0], "\n";    // first character
echo substr($word, -1), ' ', $word[-1], "\n";     // last character
echo substr($word, 1), "\n";                     // drop the first character

Обращение к несуществующей позиции печатает предупреждение, а substr() просто возвращает пустую строку. Если строка может быть пустой, предпочитайте substr().

За пределами строки: пустая строка, а не false

Если $offset за концом строки, substr() в PHP 8 возвращает "". В PHP 7 она возвращала false, поэтому старый код с проверкой === false больше не работает.

<?php
var_dump(substr('abc', 5));       // start past the end
var_dump(substr('abc', 1, 100));  // length longer than the rest is fine
var_dump(substr('abc', -10));     // negative offset before the start: from 0

Японский текст: используйте mb_substr

UTF-8 хранит кану и распространённые иероглифы по 3 байта (редкие иероглифы вроде 𠮷 и эмодзи занимают 4). substr() считает байты, поэтому substr('こんにちは', 0, 3) возвращает только こ, а длина, которая не попадает на границу символа, разрезает символ пополам и даёт испорченный текст. mb_substr() принимает те же аргументы и считает символы.

<?php
$greeting = 'こんにちは世界';

echo substr($greeting, 0, 3), "\n";       // 3 bytes = 1 character
echo mb_substr($greeting, 0, 3), "\n";    // 3 characters
echo mb_substr($greeting, -2), "\n";      // last 2 characters

// Cutting at 4 bytes splits a character: the result is not valid UTF-8
var_dump(mb_check_encoding(substr($greeting, 0, 4), 'UTF-8'));

То же относится к эмодзи, кириллице и буквам с диакритикой вроде é. Число символов считает mb_strlen(); о байтах и символах смотрите strlen().

Сокращение текста с многоточием

Обрезка длинного заголовка для списка или карточки это самое частое реальное применение substr(). Используйте mb_substr(), чтобы японский или русский заголовок никогда не разрезался посреди символа, и добавляйте ..., только когда действительно что-то сократили.

<?php
function excerpt(string $text, int $max): string
{
    if (mb_strlen($text) <= $max) {
        return $text;
    }
    return rtrim(mb_substr($text, 0, $max)) . '...';
}

echo excerpt('Short title', 20), "\n";
echo excerpt('A much longer title that will not fit in the card', 20), "\n";
echo excerpt('東京から大阪までの新幹線の旅', 8), "\n";

mb_strimwidth($text, 0, $width, '...') делает то же по ширине отображения, где полноширинный японский символ считается за 2 колонки, а латинская буква за 1. Это подходит для вёрстки с фиксированной шириной.

Подсчёт подстроки через substr_count

substr_count($haystack, $needle) возвращает, сколько раз встречается $needle. Функция учитывает регистр и не считает перекрывающиеся совпадения.

<?php
echo substr_count('banana', 'an'), "\n";
echo substr_count('aaaa', 'aa'), "\n";      // 2, not 3: no overlaps
echo substr_count('Hello hello', 'hello'), "\n";
echo substr_count(strtolower('Hello hello'), 'hello'), "\n";

substr вместе с strpos: текст до или после символа

Соедините substr() со strpos(), чтобы резать по символу, позиция которого заранее неизвестна, например по @ в адресе email:

<?php
$email = 'ada.lovelace@example.com';
$at = strpos($email, '@');

echo substr($email, 0, $at), "\n";    // before the @
echo substr($email, $at + 1), "\n";   // after the @

// strstr does the same in one call
echo strstr($email, '@', true), "\n";

Проверяйте, что strpos() не вернула false, прежде чем использовать её результат: если символа нет, false молча считается 0, поэтому substr('nobody', 0, $at) возвращает "", а substr('nobody', $at + 1) возвращает "obody".