PHP substr(): obtener una parte de un string

substr($string, $offset, $length) devuelve la parte de $string que empieza en la posición $offset (contando desde 0) y tiene $length caracteres. substr('Hello world', 0, 5) devuelve "Hello". Omite $length para obtener todo hasta el final.

<?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() cuenta bytes. Eso equivale a caracteres en texto en inglés, pero no en japonés, chino, emojis o letras con tilde. Para esos casos usa mb_substr(), que se muestra más abajo.

Sintaxis

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

• $offset es dónde empezar. 0 es el primer carácter. Un valor negativo cuenta desde el final.
• $length es cuántos bytes tomar (un byte es un carácter en texto ASCII simple). Un valor negativo deja fuera esa cantidad del final. null (u omitirlo) significa "hasta el final".

Desplazamiento y longitud negativos: trabajar desde el final

Un $offset negativo empieza a contar desde el final de la cadena, así que -1 es el último carácter. Un $length negativo se detiene esa cantidad de caracteres antes del final.

<?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) es la forma habitual de quitar el último carácter, por ejemplo una coma final que dejó un bucle.

Obtener el primer o el último carácter

Para un solo byte también puedes indexar la cadena directamente. $s[0] es el primer carácter y, desde PHP 7.1, $s[-1] es el último.

<?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

Indexar una posición que no existe imprime un warning, mientras que substr() simplemente devuelve una cadena vacía. Si la cadena puede estar vacía, prefiere substr().

Fuera de rango: una cadena vacía, no false

Si $offset está más allá del final de la cadena, substr() devuelve "" en PHP 8. En PHP 7 devolvía false, así que el código antiguo que comprueba === false ya no funciona.

<?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

Texto japonés: usa mb_substr

UTF-8 guarda los kana y los kanji comunes en 3 bytes cada uno (los kanji raros como 𠮷 y los emojis ocupan 4). substr() cuenta bytes, así que substr('こんにちは', 0, 3) devuelve solo こ, y una longitud que no cae en un límite de carácter parte un carácter por la mitad y produce texto roto. mb_substr() acepta los mismos argumentos y cuenta caracteres.

<?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'));

Lo mismo se aplica a los emojis y a las letras con tilde como é. Para contar caracteres se usa mb_strlen(); consulta strlen() para la diferencia entre bytes y caracteres.

Acortar texto con puntos suspensivos

Recortar un título largo para una lista o una tarjeta es el uso real más común de substr(). Usa mb_substr() para que un título en japonés nunca se corte a mitad de carácter, y añade ... solo cuando realmente hayas acortado algo.

<?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, '...') hace lo mismo según el ancho de visualización, donde un carácter japonés de ancho completo cuenta como 2 columnas y una letra latina como 1. Encaja con diseños de ancho fijo.

Contar una subcadena con substr_count

substr_count($haystack, $needle) devuelve cuántas veces aparece $needle. Distingue mayúsculas y minúsculas y no cuenta coincidencias solapadas.

<?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 con strpos: el texto antes o después de un carácter

Combina substr() con strpos() para cortar en un carácter cuya posición no conoces de antemano, como la @ de una dirección de 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";

Comprueba que strpos() no devolvió false antes de usar su resultado: si el carácter no está, false se trata como 0 sin ningún warning, así que substr('nobody', 0, $at) devuelve "" y substr('nobody', $at + 1) devuelve "obody".