Volver al blog
PHPDockerLaravel

PHP 8.6 cambia a ZTS en las imágenes oficiales de Docker

Actualizar a php:8.6-fpm ya no es solo cambiar de versión: ahora también cambia cómo se ha compilado PHP.

Por Isma5 min de lectura

El cambio está dentro de tu imagen base

Si tienes un Dockerfile de Laravel que parte de php:8.6-fpm, conviene parar antes de hacer el cambio de versión sin más. Las imágenes oficiales de PHP 8.6 se están construyendo con ZTS activado por defecto, también la variante FPM. No es una opción de PHP que puedas alternar desde php.ini, sino una decisión tomada durante la compilación del intérprete.

ZTS significa Zend Thread Safety. En la práctica, PHP se ha compilado con soporte para seguridad de hilos y eso forma parte de las características del binario que acabas ejecutando. El Dockerfile oficial de la variante FPM incluye explícitamente la opción --enable-zts junto con --enable-fpm.

Para una aplicación Laravel que usa solo extensiones habituales instaladas desde la propia imagen, puede que la actualización no requiera cambios visibles. Aun así, no lo trataría como una actualización menor de la imagen base. Si tu contenedor incluye binarios, extensiones nativas o software distribuido fuera del ecosistema estándar de PHP, el tipo de compilación importa.

Comprueba la imagen que vas a desplegar

No hace falta deducir si la imagen usa ZTS a partir del nombre de la etiqueta. Puedes comprobarlo dentro del mismo contenedor que vas a construir o desplegar. PHP expone esta información mediante php -i y también mediante la constante PHP_ZTS.

FROM php:8.6-fpm
 
RUN php -i | grep 'Thread Safety' \
    && php -r 'var_dump(PHP_ZTS);' \
    && php -m

La salida de php -i debe indicar que la seguridad de hilos está activada, y PHP_ZTS debe evaluarse como verdadera. Añadir esta comprobación durante la migración no arregla incompatibilidades, pero evita asumir que desarrollo, CI y producción están ejecutando la misma clase de binario. También deja una pista clara en los logs del build cuando toque revisar el cambio dentro de unos meses.

Yo ejecutaría además la batería de pruebas de Laravel sobre la imagen final, no sobre una instalación local de PHP distinta. Eso incluye los tests de integración que cargan extensiones, conectan con servicios externos o activan observabilidad. El objetivo no es demostrar que ZTS mejora o empeora nada, sino detectar dependencias que daban por hecho otro build de PHP.

Las extensiones nativas son el punto delicado

Las extensiones compiladas para PHP no son archivos intercambiables entre cualquier combinación de versión, arquitectura y configuración del intérprete. Si compilas una extensión propia, usa la misma imagen base de PHP 8.6 que emplearás en producción. Hacer el build en una imagen anterior y copiar el resultado a php:8.6-fpm es justo el tipo de atajo que merece una revisión ahora.

Revisa también las extensiones instaladas desde repositorios privados, artefactos precompilados y paquetes proporcionados por terceros. No hace falta asumir que fallarán, pero sí confirmar que el proveedor soporta PHP 8.6 compilado con ZTS. La comprobación debe incluir instalación, carga de la extensión y el recorrido real de la aplicación que la utiliza.

Los agentes APM merecen el mismo tratamiento. Muchos se integran como extensiones nativas o dependen de componentes cargados por PHP durante el arranque. Antes de publicar la nueva imagen, verifica la matriz de compatibilidad del proveedor para PHP 8.6 y ZTS, y prueba que el agente sigue enviando datos desde un entorno equivalente a producción.

La letra pequeña que no conviene ignorar

ZTS no convierte automáticamente una aplicación Laravel en una aplicación paralela ni hace que un proceso FPM procese varias peticiones dentro del mismo intérprete. FPM mantiene su propio modelo de procesos y su configuración no cambia por el mero hecho de usar una compilación ZTS. Este cambio tampoco sustituye una revisión de los límites de memoria, los workers de FPM o el número de réplicas del contenedor.

Tampoco es una garantía de compatibilidad con cualquier extensión. PHP documenta, por ejemplo, que la función chroot() no está disponible en intérpretes compilados con ZTS. Es un caso concreto, pero ilustra el punto importante: el modo de compilación puede afectar a características disponibles y a expectativas de software que interactúa con el runtime.

No publicaría un artículo afirmando cambios de rendimiento sin mediciones reproducibles para una carga concreta. En una aplicación web hay demasiadas variables entre PHP, FPM, OPcache, la base de datos, la red y el código de la aplicación. La decisión útil aquí es más simple: trata el salto a php:8.6-fpm como una actualización de PHP y como un cambio de build al mismo tiempo.

Una migración razonable para Laravel

Primero, construye una rama de prueba usando la etiqueta de PHP 8.6 que tengas previsto desplegar. Después, instala todas las extensiones y agentes exactamente igual que en producción, ejecuta los tests y arranca los procesos web y de cola. Por último, comprueba los logs de arranque de PHP, FPM y tus integraciones de observabilidad antes de promover la imagen.

Si usas una imagen derivada compartida por varios proyectos, centraliza allí la comprobación de ZTS y la instalación de extensiones. Así evitas que cada repositorio resuelva el cambio de una forma distinta o que alguien copie una extensión compilada para otro entorno. Documentar la decisión junto al Dockerfile será más útil que dejarla escondida en una incidencia de actualización.

La conclusión no es que haya que evitar PHP 8.6. La conclusión es que FROM php:8.6-fpm deja de significar únicamente “una versión nueva de PHP” y pasa a introducir un modo de compilación distinto respecto a las imágenes NTS habituales. Verificarlo en tu build y probar lo que cargas de forma nativa es bastante menos costoso que descubrirlo después de desplegar.


Fuente: https://discourse.thephp.foundation/t/php-dev-docker-images-for-8-6-now-default-to-zts/6479

Documentación oficial y Dockerfile: https://github.com/docker-library/php/blob/master/8.6/bookworm/fpm/Dockerfile

Documentación oficial de PHP: https://www.php.net/manual/en/function.chroot.php

Newsletter

Lo que aprendo programando con IA, cada dos semanas en tu correo.

Cifras reales, errores incluidos. Sin spam y te das de baja con un clic.

Sin spam y te das de baja con un clic. Uso tu correo solo para enviarte esto y la newsletter. Más en la política de privacidad.