PHP 8.6 disponible
PHP 8.6.0 salió esta mañana, en la fecha prevista. Y eso que el otoño ha sido intenso para el equipo del proyecto, con los parches de seguridad relacionados con PHP2Shell, que resumí en un artículo anterior. Da gusto ver que la nueva versión llega a tiempo.
Leí el anuncio oficial completo. Esto es lo que me quedo para el código del día a día, y después, lo que conviene revisar antes de actualizar un proyecto.
Un signo de interrogación en una llamada a función
Es la novedad que más va a dar que hablar. Si te encuentras substr(?, 4) al revisar código, no es una errata.
Pongamos una importación de catálogo en la que las referencias llegan con la forma SKU-4821. Para quitar el prefijo, hasta ahora escribíamos una pequeña función flecha:
$numeros = array_map(fn (string $ref) => substr($ref, 4), $references);
Con PHP 8.6 se puede escribir:
$numeros = array_map(substr(?, 4), $references);
// ['4821', '7310']
El ? marca un argumento que se pasará más tarde. substr(?, 4) todavía no llama a substr(): PHP crea una closure que espera la cadena que falta, y array_map() se la pasa con cada referencia. La documentación lo llama aplicación parcial de funciones. El marcador ... deja libres todos los argumentos restantes.
Al ojo le costará un poco acostumbrarse. Pero cuando una función flecha solo servía para pasar un argumento, la versión corta se lee mejor. El anuncio también indica que array_map() ahora se compila como un bucle cuando recibe este tipo de callback.
clamp(), por fin
Una API paginada acepta como máximo 100 productos por página. Un cliente pide 500. Antes escribíamos algo como max(1, min($quantite, 100)), y siempre había que leerlo dos veces para saber qué límite iba dónde.
$parPage = clamp($quantite, 1, 100);
El valor, el mínimo, el máximo, en el orden en que lo dirías en voz alta. Con 500 obtienes 100. Con 25 te quedas con 25. clamp() acepta cualquier valor comparable, no solo números.
Duraciones que dicen su unidad
Un retardo de 250, ¿es mucho? Depende de lo que tenía en mente quien escribió el método. Milisegundos, microsegundos, segundos: la firma int $delai no lo dice.
La nueva clase \Time\Duration resuelve la duda en la propia llamada:
use Time\Duration;
$delai = Duration::fromMilliseconds(250);
$maximum = Duration::fromSeconds(30);
$attente = min($delai, $maximum);
time_nanosleep($attente->seconds, $attente->nanoseconds);
Las duraciones se pueden comparar entre sí, así que min() y clamp() funcionan directamente. La clase representa tiempo transcurrido, como en un cronómetro, sin fecha ni zona horaria. No sustituye a DateInterval para los cálculos de calendario. Para un tiempo de espera, una pausa entre dos reintentos o un benchmark, viene como anillo al dedo.
Dos detalles que aligeran el código
Las propiedades readonly ya pueden tener un valor por defecto. Se acabó el constructor cuyo único papel era asignar una constante:
final readonly class RegleSlug implements Regle
{
public string $parser = SlugParser::class;
}
El valor por defecto cuenta como la inicialización de la propiedad, así que el constructor no puede sobrescribirlo.
PHP añade también la enumeración SortDirection, con los casos Ascending y Descending. Cada biblioteca tenía su manera de expresar el sentido de una ordenación: una cadena, un entero, un booleano, su propio enum. Con un tipo que proporciona el lenguaje, un método como trierPar(string $colonne, SortDirection $sens) rechaza un argumento incorrecto en la misma llamada, con un TypeError claro.
Para quienes escriben servidores
Imagina un servidor de chat con mil clientes conectados, de los que solo unos pocos envían un mensaje en un momento dado. Hasta ahora, PHP ofrecía stream_select(), que se basa en select() y rara vez maneja más de 1024 conexiones.
La nueva API Io\Poll espera a que los streams estén listos para lectura o escritura, con el mecanismo del propio sistema: epoll en Linux, kqueue en macOS, los event ports o WSAPoll en otros. Está pensada sobre todo para los autores de bucles de eventos como ReactPHP y AMPHP. Si escribes una aplicación Laravel o Symfony clásica, probablemente no la toques directamente, pero las bibliotecas que usas podrán apoyarse en ella.
Antes de pasar un proyecto a 8.6
Algunos cambios merecen un vistazo, aunque tu código no use ninguna de las novedades.
El primero es la deprecación de return dentro de un bloque finally. Un return así sobrescribe el valor devuelto por el try y hace desaparecer la excepción que iba subiendo. Este código, por ejemplo, siempre devuelve null, incluso cuando la lectura funciona:
public function lire(string $chemin): ?array
{
try {
return json_decode(file_get_contents($chemin), true, flags: JSON_THROW_ON_ERROR);
} finally {
return null;
}
}
Si tus tests señalan este caso, decide primero qué debe hacer el método cuando falla: devolver null en un catch o dejar que la excepción suba. Solo después, mueve el return.
Las sesiones también son más estrictas por defecto. session.use_strict_mode y session.cookie_httponly están activados, y session.cookie_samesite vale Lax. Si algún JavaScript leía la cookie de sesión, ya no podrá hacerlo.
Un último detalle, más discreto: trim(), ltrim() y rtrim() ahora también eliminan por defecto el salto de página (\f). Poco código depende de ello, pero un test que compare cadenas byte a byte puede notarlo.
En un proyecto gestionado con Composer, composer prohibits php 8.6.0 lista las dependencias cuya restricción bloquea la actualización. La lista completa de cambios está en la guía de migración y en el registro de cambios de PHP 8.6.0.
Para ver también
- PHP 8.6 is out. Here's everything you need to know, el vídeo de Nuno Maduro (en inglés).
- PHP 8.6 : ce qui change vraiment (et ce qui risque de casser), de Pentiminax (en francés).
Artículo escrito por Jatniel, desarrollador full stack PHP sénior.