En este post voy a explicar cómo podemos truncar una cadena si su longitud es mayor a un valor que nosotros designemos usando el lenguaje PHP.

Además de truncar la cadena con PHP vamos a ver cómo agregarle puntos suspensivos o tres puntos: ... (y cualquier otro sufijo, o dejarlo vacío)

Esto también se puede hacer con CSS pero aquí lo haremos con PHP.

Limitar cadena en PHP usando strlen y substr

Este enfoque aplica con PHP y con cualquier otro lenguaje que permita cortar una cadena y conocer la longitud de la misma. Se trata de comparar la longitud, y si es mayor que el límite entonces se corta.

Las 2 funciones que permiten eso son strlen y substr; si queremos tratar con cadenas multibyte usamos mb_strlen y mb_substr.

La función y la forma de uso queda así:

<?php
/*
 Limitar / Cortar una cadena en PHP y agregarle
 puntos suspensivos si es necesario

 @author parzibyte
*/function limitar_cadena($cadena, $limite, $sufijo){
 // Si la longitud es mayor que el límite...
 if(strlen($cadena) > $limite){
  // Entonces corta la cadena y ponle el sufijo
  return substr($cadena, 0, $limite) . $sufijo;
 }
 
 // Si no, entonces devuelve la cadena normal
 return $cadena;
}

// Formas de uso
# Limitar a 3 caracteres y si es más larga cortarla, agregándole puntos suspensivos
echo limitar_cadena("Hola mundo soy una cadena muy larga", 3, "...");
echo "\n\n";
# Limitar a 15 caracteres y si es más larga cortarla, pero no agregar nada al final
echo limitar_cadena("Hola mundo soy una cadena muy larga", 15, "");

Para invocar a la función se le pasa la cadena que se va a cortar, el límite de caracteres y un sufijo. Podemos mandar el sufijo como cadena vacía para que no se le agregue nada al final.

Lo que acabamos de hacer funciona, aunque le faltan validaciones. Veamos otra función.

Str::limit() de Laravel

El framework Laravel tiene una función para limitar las cadenas y agregarles un posible sufijo. Su definición la podemos ver en el repositorio de GitHub. Para adaptarla haríamos esto:

<?php
/*
 Tomada de: https://github.com/laravel/framework/blob/5.8/src/Illuminate/Support/Str.php#L212
*/function str_limit($value, $limit = 100, $end = '...'){
  if (mb_strwidth($value, 'UTF-8') <= $limit) {
    return $value;
  }
  return rtrim(mb_strimwidth($value, 0, $limit, '', 'UTF-8')).$end;
}

// Formas de uso
# Limitar a 3 caracteres y si es más larga cortarla, agregándole puntos suspensivos
echo str_limit("Hola mundo soy una cadena muy larga", 3, "...");
echo "\n\n";
# Limitar a 15 caracteres y si es más larga cortarla, pero no agregar nada al final
echo str_limit("Hola mundo soy una cadena muy larga", 15);

Las ventajas que ofrece esta función es que elimina los espacios en blanco en caso de que queden al final de la cadena, además de que usa una función nativa de las cadenas multibyte.

Hablando de código, esta función necesita únicamente el primer argumento: la cadena. Si no enviamos el límite supondrá que es 100, y si no enviamos el sufijo supondrá que es “…”.

Conclusión

Así es como podemos cortar o limitar cadenas con PHP.

Puede que cambiemos el código de acuerdo a nuestras necesidades; y cuando sabemos cómo funcionan las cosas de manera interna entonces podemos hacerlo.