Si tu Dockerfile falla con pecl: not found al cambiar a php:8.6, no has roto nada: las imágenes oficiales de PHP 8.6 ya no incluyen pecl ni pear, y tampoco traen mbstring compilado. La herramienta que sustituye a PECL es PIE (PHP Installer for Extensions). Pero el 20 de noviembre de 2026 las versiones estables de redis, apcu e imagick no compilan contra PHP 8.6, así que en producción fija php:8.5 y deja la 8.6 para pruebas. Lo he reproducido en Docker sobre arm64 el día después del lanzamiento, con WordPress y Nextcloud reales. La guía también está en inglés.

Puntos clave

  • PHP 8.6.0 salió el 19 de noviembre de 2026. Las imágenes php:8.6, 8.6-fpm y 8.6-apache no tienen pecl, pear ni mbstring, y todas están compiladas en modo ZTS (thread safe).
  • RUN pecl install redis termina con /bin/sh: 1: pecl: not found y código de salida 127. En php:8.5-fpm el mismo comando sigue existiendo.
  • De 8 extensiones PECL que probé con PIE 1.5.5, solo mongodb 2.5.8 se instaló en versión estable. Cinco fallaron al compilar, Xdebug 3.5.3 exige PHP inferior a 8.6 e igbinary no tiene versión instalable.
  • Las ramas de desarrollo de phpredis, apcu, imagick, memcached y Xdebug sí compilan y se cargan. No son versiones publicadas.
  • WordPress 7.1.5 funciona en PHP 8.6 con avisos de obsolescencia. Nextcloud 35.0.3 se niega a arrancar con un error 500.

Por qué aparece pecl: not found en php:8.6

El error sale porque la imagen ya no trae el binario. Esto es lo que imprime BuildKit con un Dockerfile de dos líneas sobre php:8.6-fpm:

#5 [2/2] RUN pecl install redis && docker-php-ext-enable redis
#5 0.082 /bin/sh: 1: pecl: not found

El paso termina con exit code: 127, el código que devuelve el shell cuando no encuentra un comando. Los mantenedores de la imagen oficial quitaron la opción --with-pear para PHP 8.6 en el PR 1654 de docker-library/php[1], fusionado el 25 de junio de 2026. Sin PEAR no hay pecl. La decisión sigue a la RFC de PHP que adopta PIE y deja obsoleto PECL[2], aprobada por 36 votos a 0 en septiembre de 2025: "PECL becomes formally deprecated as the recommended installation method for non-bundled PHP Modules and Zend Extensions."

No va a volver. Un usuario lo reportó en la issue 1682[3] con la primera RC. Tianon Gravi, uno de los mantenedores, respondió: "Yep, this is intentional and this time it's for keeps." Las imágenes de PHP 8.5 y anteriores conservan pecl, porque el cambio solo se aplica desde la 8.6.

Los otros dos cambios de la imagen php:8.6

pecl no es lo único que falta. Comparé php:8.5-fpm (8.5.13) y php:8.6-fpm (8.6.0) con los mismos comandos:

Comprobación php:8.5-fpm php:8.6-fpm
pecl y pear Sí No
mbstring en php -m Sí No
Modo de compilación NTS ZTS
Directorio de extensiones no-debug-non-zts-20250925 no-debug-zts-20261112

La extensión mbstring ya no viene compilada porque la imagen dejó de instalar oniguruma, la biblioteca de expresiones regulares que usa mb_ereg(). PHP 8.6 deja obsoletas esas funciones, según las notas de la versión 8.6[4]. Si la instalas como antes, la configuración falla:

checking for oniguruma... no
configure: error: Package requirements (oniguruma) were not met:
Package 'oniguruma', required by 'virtual:world', not found

El modo ZTS viene del PR 1686[5]: desde la 8.6 todas las variantes se compilan con hilos, también cli, fpm y apache. Las extensiones compiladas en tu Dockerfile no lo notan. Un .so copiado de una imagen NTS o de otra versión no carga, así que vuelve a compilarlo.

Cómo instalar extensiones en php:8.6 con PIE

PIE se instala copiando un único binario desde su imagen oficial, y necesita libtool para compilar. Sin libtool, PIE 1.5.5 avisa con The following build tools are missing: libtoolize/glibtoolize y la compilación falla después. Este Dockerfile compila en php:8.6-fpm el 20 de noviembre de 2026:

FROM php:8.6-fpm
COPY --from=ghcr.io/php/pie:bin /pie /usr/bin/pie
RUN apt-get update \
 && apt-get install -y --no-install-recommends \
      libtool git unzip libmagickwand-dev \
 && rm -rf /var/lib/apt/lists/*
RUN docker-php-ext-configure mbstring --disable-mbregex \
 && docker-php-ext-install mbstring
RUN pie install phpredis/phpredis:dev-develop \
 && pie install apcu/apcu:dev-master \
 && pie install imagick/imagick:dev-master

La línea de mbstring evita oniguruma con --disable-mbregex. Con ella, mb_strlen() funciona y mb_ereg() deja de existir.

Si tu código usa mb_ereg(), instala libonig-dev y compílala sin esa opción, sabiendo que la función ya está obsoleta. PIE habilita cada extensión al instalarla, así que no hace falta docker-php-ext-enable. Comprueba el resultado así:

docker build -t php86-ext .
docker run --rm php86-ext php -m | grep -E '^(mbstring|redis|apcu|imagick)$'
docker run --rm php86-ext php -r 'echo phpversion("redis"), PHP_EOL;'

En mi prueba aparecen las cuatro extensiones, y phpversion("redis") devuelve 6.3.0RC1. La versión de apcu es 5.1.29-dev. Son ramas de desarrollo tomadas el 20 de noviembre: otro build otro día puede dar otro código.

Qué extensiones compilan hoy en PHP 8.6

El arreglo anterior usa ramas de desarrollo porque las versiones estables no compilan. Probé cada extensión con pie install y su versión estable más reciente, y después con la rama principal:

Extensión Versión estable Resultado estable Rama de desarrollo
mongodb 2.5.8 Compila y carga No hizo falta
redis 6.3.0 Error de compilación Compila
apcu 5.1.28 Error de compilación Compila
imagick 3.8.1 Error de compilación Compila
memcached 3.4.0 Error de compilación Compila
msgpack 3.0.1 Error de compilación No probada
xdebug 3.5.3 PIE la rechaza Compila
igbinary Ninguna Sin paquete instalable Sin paquete

Los errores de compilación vienen de macros y funciones que PHP 8.6 retiró de su API interna, como XtOffsetOf, zval_dtor e INI_STR. Así falla phpredis 6.3.0, con la sugerencia final del compilador recortada en cada línea:

common.h:16:73: error: implicit declaration of function 'XtOffsetOf'
redis_array.c:69:9: error: implicit declaration of function 'zval_dtor'
library.c:142:53: error: implicit declaration of function 'INI_STR'

Xdebug no llega a compilar, porque su paquete declara un límite de versión. PIE responde: Cannot use xdebug/xdebug's latest version 3.5.3 as it requires php >=8.0,<8.6 which is not satisfied by your platform. Las extensiones de PHP que trae el código fuente (gd, intl, zip, bcmath, exif, mysqli, pdo_mysql, soap, pcntl y sockets) se instalan sin cambios con docker-php-ext-install.

install-php-extensions tampoco lo resuelve

El script install-php-extensions de mlocati, habitual en Dockerfiles, sí funciona sin pecl, pero descarga las mismas versiones estables. Con install-php-extensions redis apcu imagick sobre php:8.6-fpm, el build se detuvo al compilar apcu:

ERROR: `make -j18' failed

El problema es el código de las extensiones, no el instalador.

WordPress y Nextcloud sobre PHP 8.6

WordPress arranca en PHP 8.6 y Nextcloud no. El 20 de noviembre no existe una etiqueta wordpress:php8.6 en Docker Hub, así que monté WordPress 7.1.5 sobre php:8.6-apache con MariaDB 11.

La portada, el inicio de sesión, el escritorio y la salud del sitio respondieron 200 con WooCommerce, Yoast SEO, Elementor, Contact Form 7 y Wordfence activos. El registro solo mostró avisos PHP Deprecated. Yoast SEO avisó de Calling is_subclass_of() with a string when $allow_string is false, y Elementor de que una constante de clase se llama namespace.

Nextcloud 35.0.3 comprueba la versión de PHP antes de cargar nada y responde con un error HTTP 500 y este texto:

This version of Nextcloud is not compatible with PHP>=8.6.<br/>You are currently running 8.6.0.

El bloqueo está en lib/versioncheck.php y no se puede desactivar desde la configuración. Si tu Nextcloud usa una imagen propia basada en php:*-apache con una etiqueta flotante, fíjala en la 8.5 antes del próximo build. La guía para actualizar Nextcloud 35 con Docker usa la imagen oficial nextcloud:35, que el 20 de noviembre trae PHP 8.5.13 y no tiene este problema.

Qué etiqueta usar en producción

Fija php:8.5 mientras tus extensiones no publiquen una versión estable para 8.6. La 8.5 tiene soporte activo hasta el 31 de diciembre de 2027, según endoflife.date[6], y el 19 de noviembre recibió la 8.5.13 de seguridad. Si construyes sobre php:fpm o php:latest, esas etiquetas pueden saltar a la 8.6 en cualquier build. Cambia el FROM a una versión explícita:

FROM php:8.5-fpm

Con PHP 8.5 tu pecl install sigue funcionando, aunque PECL ya está obsoleto. Si quieres adelantarte, cambia a PIE en la 8.5: el mismo COPY --from=ghcr.io/php/pie:bin sirve desde PHP 8.1. Mantén la imagen al día con las versiones de seguridad, como explica la guía sobre comprobar las CVE de PHP de octubre.

Preguntas frecuentes

¿Sirve de algo recuperar pecl en php:8.6?

No merece la pena. install-php-extensions descarga los paquetes de PECL sin usar pecl, y apcu falló igual al compilar. Recuperar la herramienta no arregla el código: las versiones estables de redis, apcu e imagick no compilan contra la API de PHP 8.6, vengan de PECL o de PIE.

¿Las ramas de desarrollo son seguras para producción?

No. Compilan y cargan, pero son código sin publicar. Úsalas para probar tu aplicación en PHP 8.6 y vuelve a la versión estable en cuanto salga una compatible. Con PIE, quita el sufijo :dev-develop o :dev-master.

¿Afecta lo mismo a amd64?

Sí. Lo comprobé en linux/amd64 con php:8.6-cli: tampoco tiene pecl ni mbstring y también es ZTS. Los errores de compilación están en el código C de las extensiones, así que no dependen de la arquitectura.

Conclusión

pecl: not found en php:8.6 es un cambio deliberado de la imagen oficial, no un fallo pasajero. La herramienta que lo sustituye es PIE, y mbstring se compila con --disable-mbregex.

El freno real es otro: a 20 de noviembre de 2026, las versiones estables de redis, apcu, imagick, memcached y msgpack no compilan contra PHP 8.6, y Nextcloud 35 se niega a arrancar. Fija php:8.5 en producción, prueba la 8.6 con las ramas de desarrollo y vuelve a construir cuando cada extensión publique su versión compatible. Si usas Redis como caché de objetos, la guía para instalar Redis con Docker cubre el servidor.

Fuentes: [1] PHP, notas de la versión 8.6[4], [2] docker-library/php, PR 1654: retirar --with-pear en PHP 8.6[1], [3] docker-library/php, issue 1682: no hay pecl en 8.6-rc[3], [4] docker-library/php, PR 1686: imágenes ZTS desde la 8.6[5], [5] PHP RFC, adoptar PIE y dejar obsoleto PECL[2], [6] PIE, instalador de extensiones de PHP[7], [7] endoflife.date, calendario de soporte de PHP[6], [8] Docker Hub, imagen oficial de PHP[8].

Fuentes

  1. PR 1654 de docker-library/php
  2. RFC de PHP que adopta PIE y deja obsoleto PECL
  3. issue 1682
  4. notas de la versión 8.6
  5. PR 1686
  6. endoflife.date
  7. PIE, instalador de extensiones de PHP
  8. Docker Hub, imagen oficial de PHP