XAMPP es una plataforma útil para los desarrolladores de WordPress que buscan una solución localhost. Sin embargo, algunos problemas pueden aparecer cuando se utiliza esta herramienta. Estos errores podrían detener tu flujo de trabajo y dejarte inseguro sobre cómo hacer que XAMPP vuelva a funcionar, especialmente porque todo puede parecer en orden en la superficie.

Afortunadamente, una vez que identificas la razón por la que XAMPP no se inicia para ti, a menudo sólo se necesitan unos pocos ajustes para solucionarlo. Entonces puedes volver a trabajar en tu último proyecto de desarrollo.

En este artículo, proporcionaremos una breve descripción de lo que es XAMPP para aquellos que son nuevos en la plataforma. Luego te mostraremos cómo comprobar tus registros de error y resolver tres problemas comunes que pueden impedir que tu servidor local se inicie. Vamos a sumergirnos!

Breve introducción a XAMPP

XAMPP es una herramienta de desarrollo local gratuita. Esencialmente funciona como un servidor en su ordenador que puede utilizar para alojar sitios web – como DevKinsta, nuestra propia aplicación gratuita de desarrollo local.

Ten en cuenta que estos sitios no están disponibles públicamente para los usuarios en la Internet abierta. Más bien, están pensados para ser utilizados localmente con fines de desarrollo y prueba. Si lo deseas, puedes migrar cada proyecto a un servidor en vivo una vez que esté terminado.

XAMPP es una solución práctica porque evita que los visitantes encuentren tu proyecto mientras está en progreso. Además, como el sitio está alojado en tu ordenador, su rendimiento debería ser de primera categoría y puedes trabajar sin conexión.

Puedes usar XAMPP en cualquier sistema operativo (OS) principal, incluyendo Windows, macOS y Ubuntu Linux. Utiliza el servidor Apache de código abierto y MySQL, y viene con varias herramientas incorporadas como phpMyAdmin y FileZilla.

Cuando se trata de WordPress en particular, XAMPP es una de las mejores soluciones de alojamiento local porque cumple con todos los requisitos del sistema de gestión de contenidos (CMS). Estos incluyen:

  • PHP 7.4
  • MySQL 5.6
  • Soporte de HTTPS
  • Servidor Apache o NGINX

Si estás interesado en instalar XAMPP, puedes consultar nuestro tutorial sobre cómo instalar WordPress localmente, que incluye instrucciones para esta tarea.

Cómo comprobar el registro de errores de PHP de XAMPP

En el caso de que estés desarrollando un sitio de WordPress localmente usando XAMPP, y no puedas conseguir que la plataforma se inicie, tu primer paso debería ser comprobar tus registros de error. Esto puede indicarte la causa del problema.

Si sabes por qué se produce el problema, deberías ser capaz de resolverlo mucho más rápido que solucionarlo por prueba y error. El acceso a los registros se realiza a través de diferentes rutas, dependiendo del sistema operativo y de la versión. Afortunadamente, hay una manera sencilla de encontrar la ruta para su configuración.

En Windows, el registro de actividad de XAMPP aparece en la mitad inferior del cuadro de diálogo del panel de control. También puedes acceder al registro de errores pulsando el botón Logs junto al botón Apache Config:

El panel de control de XAMPP incluye registros para PHP y sus otros componentes.
El panel de control de XAMPP incluye registros para PHP y sus otros componentes.

En macOS, haz clic en la pestaña Registro del panel de control para ver el registro de actividad:

La pestaña Log del panel de control de XAMPP de macOS.
La pestaña Log del panel de control de XAMPP de macOS.

A continuación, puedes echar un vistazo a tus registros para ver si hay algo sospechoso y seguir las directrices que se te indiquen para resolver el problema.

En algunos casos puede ser beneficioso tener acceso a tu registro de PHP también, aunque esto suele ser más útil para la solución de errores de WordPress que los de Apache o MySQL.

Para localizar tus registros de errores de PHP, abre el panel de control de XAMPP escribiendo http://localhost en la barra de direcciones de tu navegador. Allí, haz clic en PHPInfo en la parte superior de la pantalla:

El enlace PHPInfo en el panel de control de XAMPP.
El enlace PHPInfo en el panel de control de XAMPP.

A continuación, busca «error_log». Esto revelará la ruta que debe introducir en tu barra de direcciones para ver el registro:

Localización de la ruta error_log en PHPInfo.
Localización de la ruta error_log en PHPInfo.

Deberías poder simplemente escribir esta ruta en tu navegador después de http://localhost para ver el registro de PHP.

Acceso a los registros de PHP de XAMPP-VM para Mac

En realidad hay dos versiones de XAMPP para usuarios de Mac – «XAMPP para macOS» y «XAMPP-VM«. Esta última te permite ejecutar XAMPP para Linux en tu Mac, utilizando una máquina virtual.

Es importante saber qué versión estás usando porque determina cómo acceder a los archivos clave a los que haremos referencia a lo largo de este post. Por ejemplo, si estás usando XAMPP para OS X, puedes simplemente abrir el Finder, ir a Aplicaciones > XAMPP, y buscar la carpeta de registros para encontrar tu registro de PHP.

Sin embargo, si estás usando XAMPP-VM, primero tienes que abrir el panel de control de XAMPP, hacer clic en la pestaña Volúmenes y seleccionar Montar:

La pestaña Volúmenes del panel de control de XAMPP-VM de macOS.
La pestaña Volúmenes del panel de control de XAMPP-VM de macOS.

Entonces, cuando inicies Finder, haz clic en tu dirección IP en el menú de la izquierda y abre la carpeta lampp. Aquí es donde encontrarás todos tus archivos de XAMPP, incluyendo los registros de errores de PHP.

Cómo arreglar XAMPP si no funciona (3 soluciones comunes)

Si tus registros de error no indican la causa del problema, puedes probar estas soluciones para que XAMPP vuelva a funcionar. Estos consejos también explican algunas de las instrucciones que tu registro de errores puede estar mostrando.

1. Resolver los conflictos de puertos de Apache

Si Apache no puede arrancar, no podrás acceder a tu panel de control de XAMPP ni a los sitios que tengas instalados en la plataforma. Un conflicto de puertos puede ser el problema subyacente.

Por defecto, Apache se conecta a través del puerto 80. Si ves un mensaje de error que dice que este puerto ya está en uso, otra aplicación está bloqueando la conexión (Skype es un infractor frecuente).

Si haces clic en el botón Netstat en el panel de control de XAMPP, debería mostrarte todos los puertos que están actualmente en uso, y qué aplicaciones los están utilizando. Puedes comprobarlo si XAMPP Apache no se inicia:

Comprobación de los puertos activos mediante Netstat.
Comprobación de los puertos activos mediante Netstat.

Si sabes qué programa es el problema y puedes desbloquear el puerto eliminando la aplicación que estorba, esto resolverá el problema inmediatamente. Sin embargo, también puedes cambiar el puerto de escucha de Apache para XAMPP, de modo que te conectes dejando tus otras plataformas intactas.

Primero, necesitarás encontrar tu archivo httpd.conf. Este proceso es ligeramente diferente dependiendo de tu sistema operativo y de la versión de XAMPP que estés utilizando.

Cómo cambiar el puerto de Apache de XAMPP en Windows

En Windows, abre el panel de control de XAMPP y haz clic en el botón Config:

Acceder al archivo de configuración de Apache.
Acceder al archivo de configuración de Apache.

Luego selecciona httpd.conf. Busca en este archivo la línea que dice «Listen 80», y cámbiala por «Listen 8080». Esto le permitirá conectarse a Apache a través del puerto 8080 en lugar de la opción por defecto.

También tendrás que buscar la línea que dice ServerName localhost:80, y cambiarla por ServerName localhost:8080. Guarda y cierra el archivo.

Luego, intenta iniciar Apache de nuevo. Si éste es el único problema, la plataforma debería funcionar como es debido. Sin embargo, ten en cuenta que si tienes una instalación de WordPress alojada a través de XAMPP, tendrás que encontrar y sustituir todas las menciones de «localhost» por «localhost:8080», incluyendo las de tu base de datos.

Cómo cambiar el puerto de Apache de XAMPP en Mac

Si estás ejecutando XAMPP para macOS, puedes encontrar tu archivo httpd.conf yendo a Aplicaciones > XAMPP en el Finder. Una vez que encuentres el archivo, puedes llevar a cabo los mismos pasos para cambiar tu puerto que hemos descrito para los usuarios de Windows.

Para aquellos que usen XAMPP-VM, vuelve a la sección donde explicamos cómo acceder a tus registros de error para aprender a encontrar tus archivos XAMPP. Una vez que accedas al directorio lampp, encontrarás httpd.conf en apache2 > conf.

2. Incluir el puerto de escucha en la dirección al acceder a Localhost

Normalmente, puedes simplemente escribir http://localhost en la barra de direcciones de tu navegador para acceder a tus sitios alojados en XAMPP o a tu panel de control. La plataforma se conecta automáticamente a Apache a través de su puerto de escucha por defecto, el 80.

Sin embargo, si has cambiado el puerto de escucha de tu instalación de XAMPP (o alguien con acceso a tu ordenador lo ha hecho), no podrá conectarse. También puede ocurrir esto si hay un conflicto de puertos de Apache, como se ha descrito anteriormente.

Este problema puede ser bastante confuso porque el panel de control de XAMPP puede mostrar que Apache y MySQL están funcionando. Sin embargo, no podrás acceder a tu sitio o a herramientas como PHPInfo o phpMyAdmin.

Este error puede adoptar diferentes formas. Si estás intentando acceder a tu sitio local de WordPress, puedes ver una página de error 404. Los usuarios de Chrome pueden ver ERR_CONNECTION_REFUSED en su lugar:

La página ERR_CONNECTION_REFUSED en Chrome.
La página ERR_CONNECTION_REFUSED en Chrome.

Afortunadamente, la solución es bastante sencilla. Basta con añadir el puerto de escucha a la dirección. Por ejemplo, si estás usando el puerto alternativo más común, introducirías http://localhost:8080 en lugar de sólo http://localhost.

Sin embargo, si deseas poder introducir simplemente localhost aunque haya cambiado el puerto de escucha de Apache, puedes hacerlo.

Cambiar el puerto por defecto en Windows

Los usuarios de Windows cambian el puerto por defecto de XAMPP Apache por su nuevo puerto de escucha para no tener que especificarlo en la barra de direcciones. Para ello, haz clic en Config > Configuración de servicios y puertos > Apache en el panel de control de XAMPP:

Estableciendo un nuevo puerto para Apache.
Estableciendo un nuevo puerto para Apache.

A continuación, sustituye el valor del puerto principal por el nuevo puerto de Apache que ha configurado y guarde los cambios.

Configurar el reenvío de puertos en macOS

En macOS el proceso es bastante diferente. En tu panel de control, haz clic en la pestaña Red. Aquí puedes configurar las reglas de reenvío de puertos:

Accede a las opciones de red de XAMPP en macOS.
Accede a las opciones de red de XAMPP en macOS.

Querrás añadir una nueva regla que redirija el tráfico del puerto por defecto a tu nuevo puerto de escucha de Apache. Si haces clic en Añadir, podrás introducir estos valores en los campos correspondientes:

Añadir una nueva regla de reenvío de puertos para XAMPP en macOS.
Añadir una nueva regla de reenvío de puertos para XAMPP en macOS.

Selecciona la regla de la lista y haz clic en el botón Activar para empezar a utilizarla.

3. Cambiar el puerto de MySQL

Finalmente, a veces XAMPP no funciona debido a un problema con MySQL, más que con Apache. Sin embargo, el problema sigue siendo a menudo un conflicto de puertos, lo que significa que a estas alturas deberías tener una buena idea de cómo solucionarlo.

En este caso, necesitarás acceder a tu archivo php.ini en lugar de tu archivo de configuración. Navegando a tu panel de control de XAMPP y haciendo clic en PHPInfo como hemos descrito anteriormente en este post te permitirá encontrar la ruta de este archivo para tu instalación:

Encuentre la ruta php.ini en PHPInfo.
Encuentra la ruta php.ini en PHPInfo.

Alternativamente, si estás usando XAMPP para Windows, puedes acceder a este archivo desde el panel de control haciendo clic en Config > PHP (php.ini):

Una vez que encuentres y abre php.ini, busca las líneas que dicen port = 3306, y cámbialas por port = 3307. Guarda y cierra el archivo, y luego reinicia MySQL.

Resumen

XAMPP es una herramienta muy útil, pero puede ser frustrante solucionar ciertos errores que te impiden acceder a tu sitio local de WordPress. Afortunadamente, a menudo se trata de conflictos de puerto para los que puedes implementar rápidamente soluciones.

En este artículo, te mostramos qué hacer si XAMPP no funciona debido a un problema con Apache o MySQL:

  1. Resuelve los conflictos de puertos de Apache cambiando tu puerto de escucha a 8080.
  2. Incluya el puerto de escucha en la dirección cuando accede a localhost.
  3. Cambia el puerto de MySQL a 3307 si otra aplicación está bloqueando el puerto por defecto 3306.

No olvides echar un vistazo a DevKinsta como alternativa a XAMPP.