Solucionar: wp-config.php no aparece en WordPress (hosting cPanel)

Si acabas de instalar WordPress en tu hosting compartido con cPanel, o acabas de mover tu sitio de un servidor a otro, y de pronto te sale una pantalla que dice «wp-config.php file is missing», no te alarmes. El error parece serio, pero en la mayoría de los casos se arregla en unos minutos y no hace falta reinstalar WordPress.

Esta guía explica qué significa realmente ese error, por qué aparece y los pasos exactos que puedes dar desde cPanel para dejar tu sitio funcionando. Está escrita para personas que llevan su propio hosting y no les da miedo abrir el Administrador de Archivos, pero que no necesariamente saben qué hace wp-config.php. Vamos a empezar por lo básico y terminamos con una lista corta de comprobaciones que puedes reutilizar la próxima vez que muevas un WordPress de sitio.

Puntos clave

• El mensaje «wp-config.php file is missing» significa que WordPress no encuentra su archivo de configuración en la raíz de la instalación.
• En nueve de cada diez casos, el archivo no está, no está en la carpeta que WordPress está leyendo o se ha renombrado sin querer.
• No hace falta reinstalar WordPress. Puedes restaurar el archivo desde una copia de seguridad, copiarlo desde el archivo de muestra que trae WordPress o volver a crearlo con los valores que te dio tu proveedor de hosting.
• El hosting compartido de cPanel incluye JetBackup en todos los planes, así que aunque el archivo se haya borrado o sobrescrito, casi siempre tienes una copia reciente disponible.
• Después de la reparación, comprueba que wp-config.php no sea legible por todo el mundo y que no haya un duplicado en una subcarpeta.

Por qué WordPress necesita wp-config.php

WordPress es una aplicación PHP. El código PHP es el mismo en cada instalación, pero cada sitio tiene su propia base de datos, sus propias claves secretas y sus propias credenciales. El archivo wp-config.php es donde viven esos valores. Cuando abres tu sitio, WordPress carga primero wp-config.php, lee el nombre de la base de datos, el usuario y la contraseña, las claves secretas y solo entonces se conecta a MySQL y sirve el resto del sitio.

Si WordPress no encuentra ese archivo, no tiene forma de saber dónde está la base de datos. Por eso aparece la pantalla del instalador, y por eso tu sitio se ve roto hasta que devuelvas el archivo a su sitio.

Dónde tiene que estar el archivo

El archivo tiene que estar al mismo nivel que las carpetas wp-admin, wp-includes y wp-content. Dentro del Administrador de Archivos de cPanel verás algo así:

/public_html
  - wp-admin/
  - wp-includes/
  - wp-content/
  - wp-config.php       <-- tiene que estar aquí
  - wp-config-sample.php
  - .htaccess
  - index.php

Si tu instalación de WordPress vive en una subcarpeta como /public_html/blog, entonces wp-config.php tiene que estar en /public_html/blog, no en /public_html. Una causa frecuente de este error es mover los archivos de WordPress a una carpeta y olvidarse de mover el archivo de configuración con ellos.

Tres formas de recuperar el archivo

Opción 1 — Restaurar desde JetBackup

Si tu plan de hosting incluye JetBackup (todos los planes de hosting compartido de Liberty Dreams lo incluyen), restaurar el archivo lleva unos clics:

1. Entra en cPanel.
2. Abre la interfaz de JetBackup 5, o la versión 4 si tu servidor todavía la usa.
3. Elige «File Backups» o «Restore Files» y escoge la copia más reciente anterior al momento en que apareció el error.
4. Descarga la copia, abre el archivo comprimido, localiza wp-config.php y súbelo a la carpeta correcta a través del Administrador de Archivos.
5. Abre tu sitio en una ventana privada del navegador para confirmar que el error ha desaparecido.

JetBackup guarda instantáneas diarias, semanales y mensuales durante una ventana móvil, lo que es suficiente para recuperar un archivo que desapareció hace una hora o hace un mes.

Opción 2 — Copiar wp-config-sample.php y rellenar los valores

Si ya no tienes una copia del archivo, puedes volver a crearlo a partir del archivo de muestra que viene con cada instalación de WordPress:

1. En el Administrador de Archivos de cPanel, activa «Mostrar archivos ocultos» (en algunas instalaciones wp-config-sample.php aparece como archivo oculto, aunque en la mayoría no).
2. Haz clic derecho sobre wp-config-sample.php, elige «Copiar» y ponle a la copia el nombre wp-config.php.
3. Haz clic derecho sobre el archivo nuevo, elige «Editar» y sustituye los valores de marcador por los que te dio tu proveedor de hosting cuando creaste la base de datos: DB_NAME, DB_USER, DB_PASSWORD, DB_HOST.
4. Guarda el archivo. WordPress ya podrá conectarse a la base de datos.

Los valores que necesitas son los mismos que escribiste cuando creaste la base de datos MySQL y el usuario en cPanel. Si no te acuerdas, abre cPanel, ve a «MySQL Databases» y allí aparecen los nombres de la base y del usuario. La contraseña solo se muestra una vez, al crearla, así que si la perdiste tendrás que restablecer la contraseña del usuario.

Opción 3 — Restaurar desde tu propia copia de seguridad

Si guardas tus propias copias de seguridad (una carpeta en tu ordenador, un archivo comprimido en tu disco, o un clon en otra cuenta de hosting), descarga la copia, extrae el archivo wp-config.php y súbelo a través del Administrador de Archivos a la ruta correcta. Funciona igual que la Opción 1; la única diferencia es que la copia viene de tu propio archivo y no de JetBackup.

Errores típicos después de la reparación

• Dejar wp-config.php con permisos 777. Los permisos correctos son 644 para el archivo y 755 para las carpetas que lo contienen. 777 hace que el archivo sea escribible por todo el mundo y es un riesgo de seguridad conocido.
• Olvidarse de actualizar el valor de DB_HOST después de una migración de servidor. En hosting compartido con cPanel el host de la base de datos es casi siempre localhost, pero si has movido el sitio a otro servidor, comprueba que el valor apunta al servidor MySQL correcto.
• Editar el archivo con un procesador de textos. Los procesadores de textos añaden caracteres invisibles que rompen PHP. Usa el editor del Administrador de Archivos de cPanel o un editor de texto plano en tu ordenador como el Bloc de Notas en Windows o TextEdit en modo texto plano en macOS.
• Tener dos copias de WordPress en carpetas distintas. Si tu dominio apunta a /public_html pero tus archivos están en /public_html/wordpress, solo una de las dos instalaciones se cargará. O bien mueves los archivos o bien cambias la raíz del documento.

Cómo encaja esto en el hosting compartido

El archivo wp-config.php es uno de los pocos archivos que WordPress lee en cada carga de página. Si desaparece, el sitio deja de funcionar al instante, y el mensaje de error que ves en el navegador es genérico a propósito: WordPress no quiere exponer credenciales de base de datos en un mensaje público. Por eso la reparación empieza siempre en cPanel, no en el escritorio de WordPress.

Los planes de hosting compartido están pensados para que puedas resolver este tipo de problemas a nivel de archivo sin abrir un ticket de soporte. JetBackup, el Administrador de Archivos y la herramienta MySQL Databases están todos dentro de la misma interfaz de cPanel, y cualquiera de ellos por sí solo es suficiente para devolver el archivo a su sitio. Si prefieres no hacerlo tú, el Companion Hosting incluye tareas de configuración y recuperación como parte del plan, así que podemos mover el archivo, recrear el usuario de la base de datos o migrar todo el sitio por ti.

Conclusión

El error «wp-config.php file is missing» casi siempre tiene una explicación sencilla: el archivo no está donde WordPress lo espera. Abre el Administrador de Archivos de cPanel, confirma que el archivo está presente en la raíz de tu instalación de WordPress, restáuralo desde JetBackup si se ha borrado, o vuélvelo a construir desde wp-config-sample.php con los valores de la base de datos que tienes en cPanel. Una vez que el archivo vuelve, tu sitio vuelve a la normalidad sin cambios en la base de datos.

Si quieres una configuración gestionada que se ocupe de estas reparaciones a nivel de archivo por ti, los planes de hosting que ofrecemos en Liberty Dreams incluyen JetBackup, Administrador de Archivos y un equipo de soporte que puede intervenir cuando algo así ocurre en un sitio en producción.

Preguntas frecuentes

¿Cómo sé si wp-config.php falta o simplemente está en la carpeta equivocada?

Abre el Administrador de Archivos de cPanel y mira al mismo nivel que wp-admin e wp-includes. Si wp-config.php no está ahí, pero puedes verlo en otra carpeta, el archivo está en el sitio equivocado y WordPress no puede leerlo. Muévelo a la carpeta que contiene wp-admin y el error desaparece.

¿Puedo reconstruir wp-config.php desde cero si no me acuerdo de los valores de la base de datos?

Puedes reconstruir el archivo, pero necesitas cuatro valores para rellenarlo: el nombre de la base de datos, el usuario, la contraseña del usuario y el host de la base de datos. En hosting compartido con cPanel, el nombre de la base y el usuario aparecen en MySQL Databases. La contraseña se puede restablecer desde la misma pantalla. El host casi siempre es localhost salvo que tu proveedor te haya indicado otra cosa.

¿Pierdo mis entradas y páginas si borro wp-config.php?

No. Las entradas y páginas viven en la base de datos MySQL, no en wp-config.php. El archivo de configuración solo le dice a WordPress cómo llegar a la base de datos. Mientras la base de datos esté intacta, tu contenido está a salvo y al recrear wp-config.php el sitio vuelve tal cual estaba.

¿Por qué el mismo error vuelve a aparecer después de restaurar el archivo?

Si wp-config.php desaparece una y otra vez, algo en el servidor lo está sobrescribiendo o borrando. La causa habitual es un script de despliegue, un plugin de seguridad configurado de forma demasiado agresiva o una tarea programada que ejecuta una rutina de limpieza. Revisa la pantalla de Tareas Programadas de cPanel y cualquier hook de despliegue que tengas configurado. Si no encuentras la causa, abrir un ticket de soporte es la forma más rápida de identificar el script que está tocando el archivo.

¿Es wp-config.php lo mismo que .htaccess?

No. wp-config.php guarda valores de configuración de WordPress como las credenciales de la base de datos y las claves secretas. .htaccess guarda reglas de reescritura de Apache y ajustes a nivel de carpeta. Los dos archivos están en la raíz de una instalación de WordPress, pero cumplen funciones distintas, y un .htaccess que falta produce un error diferente (normalmente «Not Found» en los enlaces permanentes) y no el mensaje de wp-config.