Desarrollo local con zinnector dev

zinnector dev ejecuta un WordPress real en su propia máquina, sirviendo los plugins y temas de su proyecto, con la versión de PHP que usted elija. Este artículo explica los dos entornos de ejecución que puede utilizar, cómo seleccionar las versiones, qué se sirve desde dónde y en qué parte del disco reside el entorno de ejecución, para que lo que pruebe localmente coincida con lo que despliegue.

Los dos entornos de ejecución y por qué ambos son reales

Playground es la opción predeterminada. WordPress Playground compila PHP a WebAssembly y lo ejecuta dentro de Node, de modo que un portátil sin nada más instalado que Node inicia un WordPress en cuestión de segundos. Cualquier versión de PHP desde la 5.2 hasta la 8.5 está disponible. Incluye un conjunto reducido de extensiones de PHP (intl, redis, memcached, según la compilación actual), suficiente para la mayoría de los trabajos con plugins y temas.

Docker ejecuta contenedores nativos de php-fpm y MariaDB. Es más lento, requiere un demonio de Docker y aproximadamente 1,2 GB de imágenes, y admite PHP desde 7.4 hasta 8.5; no obstante, ejecuta un PHP nativo con el conjunto completo de extensiones, incluidas imagick y gd. Es la solución adecuada cuando lo que necesita probar es una extensión que la compilación de WebAssembly no incluye.

zinnector dev                       # playground
zinnector dev --runtime docker      # PHP nativo + MariaDB

Nunca se recurre a Docker de forma silenciosa. Un desarrollador que cree estar en WebAssembly y en realidad está en Docker ha recibido una respuesta incorrecta por parte de una herramienta que intentaba ayudar; por lo tanto, debe solicitarse explícitamente por su nombre.

Elección de versiones de PHP y WordPress

zinnector dev --php 8.1 --wp 6.7    # desarrollar con una combinación específica
zinnector dev --port 9401           # cuando el 9400 esté ocupado
zinnector dev --no-login            # no iniciar sesión en wp-admin automáticamente
zinnector dev --verbose             # mostrar la salida propia del entorno de ejecución

Los valores predeterminados proceden del archivo zinnector.json del proyecto (php, wordpress, runtime y port), el cual genera zinnector new y usted debería confirmar en el repositorio para que todos los participantes del proyecto ejecuten las mismas versiones. Un parámetro en la línea de comandos prevalece sobre el archivo para esa ejecución.

La versión que usted declara y la versión que se ejecuta son datos distintos. zinnector dev --once arranca el entorno de ejecución, muestra lo que este notifica realmente (versión de PHP, versión de WordPress, extensiones cargadas) y se detiene. zinnector check --probe emplea la misma medición al comparar su proyecto con una ranura de alojamiento.

Qué se sirve desde su proyecto

El entorno de ejecución monta directamente los directorios wp-content/plugins, wp-content/themes y wp-content/mu-plugins de su proyecto, por lo que un archivo guardado se refleja al recargar la página. Los directorios que existen pero carecen de contenido real no se montan deliberadamente: montar un directorio themes/ vacío sobre los temas propios del entorno de ejecución dejaría a WordPress sin ningún tema, lo que causaría un error 500 en blanco en lugar de mostrar su sitio. Por este motivo, la estructura inicial conserva los directorios vacíos con un .gitkeep y no ocultan ningún elemento hasta que usted agregue un tema en ellos.

Dónde reside el entorno de ejecución

El entorno de ejecución de WordPress se descarga en el primer uso en lugar de distribuirse con la CLI; el paquete que contiene cada compilación de PHP pesa aproximadamente 570 MB, y un desarrollador que solo lista sitios no debería pagar ese coste. Se almacena en la caché propia de Zinnector®, ~/.cache/zinnector/runtimes/playground/<version> (o donde apunte ZINNECTOR_CACHE_DIR), nunca en su proyecto, por lo que no puede terminar en su repositorio ni en el árbol analizado por zinnector push. La descarga la realiza su propio npm, ejecutado como node npm-cli.js, jamás mediante un intérprete de comandos.

La versión del entorno de ejecución está vinculada a la versión de la CLI, de modo que dos desarrolladores de un mismo proyecto ejecutan las mismas compilaciones de PHP. zinnector dev --reset-runtime descarta el entorno de ejecución instalado y lo instala de nuevo, lo cual constituye la solución para un entorno que se instaló pero no logra iniciar.

En Node 26 o superior

La propia CLI se ejecuta en cualquier versión de Node a partir de la 24. No obstante, el módulo nativo del entorno de ejecución solo distribuye binarios precompilados para Node 24 y 25 (a fecha de septiembre de 2026). En lugar de compilar componentes —lo que en Windows exige instalar Visual Studio—, Zinnector® descarga en la misma caché un Node 24 de aproximadamente 30 MB dedicado exclusivamente al entorno de ejecución, verificado con las sumas de comprobación que publica nodejs.org. El aviso de instalación lo especifica cuando corresponde. La versión de Node de su equipo permanece inalterada.

Relacionado

• Primeros pasos · Despliegue · Referencia de comandos · Resolución de problemas