Con Docker Compose, Xdebug y PhpStorm, puedes crear un entorno de desarrollo local reproducible, aislado y f\u00e1cilmente gestionable que refleja un servidor de producci\u00f3n, mejorando la calidad de tus proyectos de WordPress.<\/p>\n\n
\u00a1Hola, compa\u00f1eros desarrolladores de WordPress y usuarios avanzados!\nHoy, estoy emocionado de compartir un tutorial completo pero sencillo sobre c\u00f3mo configurar un entorno de desarrollo local de WordPress usando Docker Compose.\nHabi\u00e9ndome unido recientemente al din\u00e1mico equipo de OnTheGoSystems<\/a>, decid\u00ed traer mi zona de confort conmigo, que es de lo que trata esta configuraci\u00f3n. <\/p>\n\n El objetivo era simple: desarrollar una configuraci\u00f3n donde pudiera tener un control granular sobre mis herramientas de desarrollo, integrando Xdebug y WP-CLI con la imagen oficial de Docker de WordPress.\nEsta configuraci\u00f3n no se trata de reinventar la rueda, sino de personalizarla para alinearse con las preferencias y estilos de trabajo individuales.\nEspero que esta gu\u00eda te sea \u00fatil para configurar un entorno similar, mejorando tu viaje en el desarrollo de WordPress. <\/p>\n\n Para aprovechar al m\u00e1ximo este tutorial, necesitar\u00e1s tener las siguientes dependencias instaladas:<\/p>\n\n Nuestro objetivo es establecer un entorno de desarrollo local de WordPress que sea aislado, reproducible y f\u00e1cilmente gestionable.\nDocker forma la columna vertebral de esta configuraci\u00f3n, proporcionando la infraestructura para contener y gestionar nuestra aplicaci\u00f3n.\nXdebug y PhpStorm son las piezas complementarias de este rompecabezas, ofreciendo capacidades mejoradas de desarrollo y depuraci\u00f3n de c\u00f3digo PHP. <\/p>\n\n Nuestro viaje comenzar\u00e1 con la creaci\u00f3n de un Dockerfile que extiende la imagen oficial de Docker de WordPress.\nMejoraremos esta imagen incorporando Xdebug y WP-CLI, herramientas fundamentales en nuestras tareas de desarrollo y depuraci\u00f3n de WordPress. <\/p>\n\n A continuaci\u00f3n, redactaremos un archivo Docker Compose para orquestar dos servicios clave: WordPress y MySQL.\nY cr\u00e9elo o no, \u00a1eso es esencialmente todo! <\/p>\n\n La belleza de esta configuraci\u00f3n es que resulta en un entorno de desarrollo local que no solo refleja un servidor de producci\u00f3n, sino que tambi\u00e9n es f\u00e1cilmente replicable.\nEsto significa que podemos duplicar la configuraci\u00f3n exacta en m\u00faltiples entornos o m\u00e1quinas con facilidad, asegurando consistencia y reduciendo problemas relacionados con la configuraci\u00f3n. <\/p>\n\n Nuestro viaje comienza con la creaci\u00f3n de un nuevo Dockerfile.\nEste archivo instruye a Docker sobre c\u00f3mo construir nuestra imagen.\nAqu\u00ed est\u00e1 la configuraci\u00f3n b\u00e1sica con la que suelo empezar: <\/p>\n En este Dockerfile, partimos de la imagen oficial de WordPress.\nLuego instalamos Xdebug y WP-CLI por separado para mayor claridad y mantenibilidad.\nEl archivo de configuraci\u00f3n de Xdebug (xdebug.ini<\/strong>) se copia en el directorio apropiado en el contenedor.\nEsto forma la base de mi configuraci\u00f3n habitual para un entorno de desarrollo local de WordPress. <\/p>\n\n Ahora que tenemos Xdebug instalado en nuestra imagen de Docker, necesitamos configurarlo para que funcione en nuestro entorno de desarrollo local.\nEsto implica crear un archivo xdebug.ini<\/strong> con los siguientes ajustes: <\/p>\n Estos ajustes habilitan la extensi\u00f3n Xdebug, la configuran para iniciar la depuraci\u00f3n con cada solicitud y definen el puerto del cliente al que debe conectarse (en este caso, 9003).\nPuede que hayas notado que a\u00fan no hemos especificado un client_host<\/strong>, pero no temas, entrar\u00e1 en juego muy pronto en nuestro proceso de configuraci\u00f3n. <\/p>\n\n A continuaci\u00f3n, crearemos un archivo docker-compose.yml<\/strong> que configurar\u00e1 nuestros servicios de WordPress y MySQL:<\/p>\n En este archivo, hemos definido dos servicios – MySQL y WordPress.\nAmbos servicios tienen nombres de contenedor \u00fanicos, para una referencia y gesti\u00f3n m\u00e1s f\u00e1ciles. <\/p>\n\n La directiva restart: always<\/strong> asegura que el servicio siempre se reiniciar\u00e1 si se detiene inesperadamente.\nSi se detiene manualmente, solo se reinicia cuando el contenedor se reinicia manualmente. <\/p>\n\n El servicio MySQL monta un volumen de Docker (db_data<\/strong>), asegurando almacenamiento persistente incluso si se elimina el contenedor.\nPara el servicio de WordPress, estamos montando un directorio local (.\/wp_data<\/strong>) en el contenedor.\nEsto significa que cualquier cambio en los archivos de WordPress en nuestro sistema local se reflejar\u00e1 en el contenedor. <\/p>\n\n Hemos a\u00f1adido dos variables de entorno adicionales para el servicio de WordPress – WORDPRESS_DEBUG<\/strong> para habilitar la depuraci\u00f3n de WordPress y XDEBUG_CONFIG<\/strong> para especificar el host cliente para Xdebug.\nEl client_host<\/strong> est\u00e1 configurado en host.docker.internal<\/strong>, que es un nombre DNS especial que se dirige a la direcci\u00f3n IP interna del host, permitiendo que Xdebug se comunique con nuestro IDE en el host. <\/p>\n\n Tenga en cuenta que la configuraci\u00f3n de client_host<\/strong> est\u00e1 adaptada para Windows y macOS.\nPara Linux, una alternativa com\u00fan es reemplazar host.docker.internal<\/strong> con la direcci\u00f3n IP real de su m\u00e1quina, que se puede obtener mediante el comando de terminal ip addr show<\/strong>. <\/p>\n\n Una vez que su Dockerfile, archivo de configuraci\u00f3n de Xdebug y archivo Docker Compose est\u00e9n listos, es hora de poner en marcha su entorno de desarrollo local de WordPress. <\/p>\n\n Para hacer esto, simplemente navegue al directorio que contiene su archivo Docker Compose en la terminal y ejecute el siguiente comando:<\/p>\n Este comando instruir\u00e1 a Docker para que inicie sus servicios en segundo plano.<\/p>\n\n Tras una ejecuci\u00f3n exitosa, tendr\u00e1 un sitio de WordPress ejecut\u00e1ndose en su m\u00e1quina local, accesible a trav\u00e9s de http:\/\/localhost:8000<\/strong>.\nCualquier cambio que realice en sus archivos PHP de WordPress ahora se reflejar\u00e1 en este sitio, ofreciendo una manera f\u00e1cil y efectiva de desarrollar y depurar su aplicaci\u00f3n de WordPress. <\/p>\n\n Adem\u00e1s, su servicio de MySQL tambi\u00e9n estar\u00e1 en funcionamiento, accesible en el puerto 3306.\nEsto proporciona una base de datos MySQL completamente funcional para su aplicaci\u00f3n de WordPress, replicando un entorno realista para sus necesidades de desarrollo. <\/p>\n\n Para aquellos que quieran profundizar un poco m\u00e1s en su configuraci\u00f3n de PHP, podemos introducir un archivo phpinfo.php<\/strong> en nuestra imagen de Docker.\nCuando se accede, este archivo presentar\u00e1 una visi\u00f3n general completa de su configuraci\u00f3n de PHP. A continuaci\u00f3n, a\u00f1ada la siguiente l\u00ednea a su Dockerfile:<\/p>\n Este comando copiar\u00e1 el archivo phpinfo.php<\/strong> en el directorio ra\u00edz de WordPress dentro de la imagen de Docker. <\/p>\n\n Para asegurar que estos cambios surtan efecto, deber\u00e1 reconstruir su imagen de Docker y reiniciar los servicios de Docker Compose.\nEjecute los siguientes comandos en su terminal: <\/p>\n El comando docker-compose down<\/strong> detiene y elimina sus contenedores de Docker actuales.\nDespu\u00e9s de esto, docker-compose up -d –build<\/strong> reconstruye la imagen de Docker con el archivo phpinfo.php<\/strong> reci\u00e9n a\u00f1adido, y reinicia sus servicios de WordPress y MySQL en segundo plano. Ahora que tiene su entorno de desarrollo local de WordPress configurado con Docker, Xdebug y PhpStorm, puede comenzar a depurar su sitio de WordPress.\nAqu\u00ed hay un resumen r\u00e1pido de c\u00f3mo empezar: <\/p>\n\nRequisitos previos<\/h2>\n\n
\n
\u00bfPor qu\u00e9 Docker, Xdebug y PhpStorm?<\/h2>\n\n
Tutorial paso a paso<\/h2>\n\n
Paso 1: El Dockerfile<\/h3>\n\n
\n# Use the official WordPress image as a parent image\nFROM wordpress:latest\n\n# Install Xdebug\nRUN pecl install xdebug \n\n# Install WP-CLI\nRUN curl -O https:\/\/raw.githubusercontent.com\/wp-cli\/builds\/gh-pages\/phar\/wp-cli.phar && \\\n chmod +x wp-cli.phar && \\\n mv wp-cli.phar \/usr\/local\/bin\/wp\n\n# Copy xdebug.ini into the container\nCOPY xdebug.ini \/usr\/local\/etc\/php\/conf.d\/xdebug.ini\n\n<\/pre><\/div>\n
Paso 2: El archivo de configuraci\u00f3n de Xdebug (xdebug.ini)<\/h3>\n\n
\nini\nzend_extension=xdebug\nxdebug.mode=debug\nxdebug.client_port=9003\nxdebug.start_with_request=yes\n\n<\/pre><\/div>\n
Paso 3: El archivo Docker Compose<\/h3>\n\n
\nyaml\nversion: '3'\nservices:\n # MySQL Service\n mysql:\n image: mysql:latest\n container_name: mysql_container\n restart: always\n volumes:\n - db_data:\/var\/lib\/mysql\n environment:\n MYSQL_ROOT_PASSWORD: root\n MYSQL_USER: wordpress\n MYSQL_PASSWORD: wordpress\n MYSQL_DATABASE: wordpress\n \n # WordPress Service\n wordpress:\n depends_on: \n - mysql\n image: wordpress:latest\n container_name: wp_container\n volumes:\n - .\/wp_data:\/var\/www\/html\n environment:\n WORDPRESS_DB_HOST: mysql\n WORDPRESS_DB_USER: wordpress\n WORDPRESS_DB_PASSWORD: wordpress\n WORDPRESS_DB_NAME: wordpress\n WORDPRESS_DEBUG: 1\n XDEBUG_CONFIG: client_host=host.docker.internal\n ports:\n - "8000:8000"\n\nvolumes:\n db_data:\n\n<\/pre><\/div>\n
Paso 4: Ejecutar su Entorno de Desarrollo Local de WordPress<\/h3>\n\n
\nbash\ndocker-compose up -d\n<\/pre><\/div>\n
Paso 4.5: Paso Adicional – A\u00f1adir el Archivo phpinfo.php<\/strong><\/h3>\n\n
\n<?php phpinfo(); ?>\n<\/pre><\/div>\n
\n# Bonus: Copy phpinfo.php into the container\nCOPY phpinfo.php \/var\/www\/html\/phpinfo.php\n<\/pre><\/div>\n
\nbash\ndocker-compose down\ndocker-compose up -d --build\n<\/pre><\/div>\n
Paso 5: Comenzar a Depurar<\/h3>\n\n
\n
Conclusi\u00f3n<\/h2>\n\n