Cómo solucionar el error 'wp-config.php not found' en WordPress
¡Hola! Soy tu técnico de soporte amigable. Si estás viendo el mensaje "wp-config.php not found" en tu sitio WordPress, no te preocupes. Este es un error muy común que suele asustar, pero te prometo que tiene solución. En esta guía, paso a paso y en un lenguaje muy sencillo, te voy a explicar qué significa este error, por qué ocurre y, lo más importante, cómo solucionarlo. Vamos a ello.
El archivo wp-config.php es como el corazón de tu instalación de WordPress. Contiene la información clave para que tu web se conecte a la base de datos, establezca las claves de seguridad y defina la configuración básica. Sin este archivo, WordPress no puede funcionar, por lo que muestra el error "wp-config.php not found".
Este error puede aparecer por varias razones, desde un simple problema de permisos de archivos hasta un error al mover o editar archivos. No te asustes, la mayoría de las soluciones son muy sencillas y no requieren conocimientos técnicos avanzados. Solo necesitas acceso a tu panel de control de hosting (como Syspanel, cPanel, etc.) y un poco de paciencia.
¿Qué causa el error "wp-config.php not found"?
Antes de lanzarnos a las soluciones, es útil entender por qué ocurre este error. Las causas más comunes son:
- El archivo no existe: Lo más obvio, pero a veces ocurre. Puede que se haya borrado accidentalmente o que la instalación no se haya completado correctamente.
- Permisos incorrectos: El servidor necesita leer el archivo. Si los permisos (los famosos "chmod") son demasiado restrictivos, el servidor no podrá acceder a él.
- Ruta incorrecta: A veces, al mover la instalación de WordPress a otra carpeta o dominio, la ruta al archivo
wp-config.phpse rompe. - Problemas con el archivo .htaccess: Este archivo de configuración del servidor puede interferir con la lectura del
wp-config.php. - Actualización o migración fallida: Durante una actualización de WordPress o una migración a un nuevo servidor, el archivo puede dañarse o perderse.
Ahora que sabemos qué puede pasarte, vamos a las soluciones. Te las presento en orden de más fácil a más compleja.
Solución 1: Verificar que el archivo existe (Solución más común)
Esta es la primera y más obvia comprobación. El error "wp-config.php not found" a veces es literal: el archivo no está donde debería.
Paso 1: Accede a tu panel de control de hosting
Utiliza el acceso a tu hosting. Por ejemplo, si usas Syspanel (el panel de control de HestiaCP), accede a través de tu-dominio.com:2106 con tus credenciales. Si usas cPanel, Plesk u otro, el acceso será similar.
Paso 2: Busca el administrador de archivos (File Manager)
Dentro de tu panel, busca una opción que se llame "Administrador de Archivos", "File Manager" o "Gestor de Archivos". Haz clic para abrirlo.
Paso 3: Navega hasta la raíz de tu WordPress
Dentro del File Manager, busca la carpeta donde tienes instalado WordPress. Normalmente es public_html o www, o una subcarpeta dentro de estas (por ejemplo, public_html/miweb). La raíz de WordPress es la carpeta que contiene las carpetas wp-admin, wp-content, wp-includes y el archivo wp-config.php.
Paso 4: Busca el archivo wp-config.php
Una vez en la raíz, busca el archivo wp-config.php. Si no lo ves, es posible que esté oculto. Busca una opción en el File Manager que diga "Mostrar archivos ocultos" o "Show Hidden Files".
[TIP]: Si no ves el archivo, puede que se haya borrado. No te preocupes, puedes crearlo de nuevo (Solución 3).
Solución 2: Verificar y corregir los permisos del archivo
Si el archivo existe pero el servidor no puede leerlo, el problema son los permisos.
Paso 1: Localiza el archivo wp-config.php
Sigue los pasos 1-3 de la Solución 1 para localizar el archivo.
Paso 2: Haz clic derecho y selecciona "Cambiar permisos" o "Permissions"
En la mayoría de los administradores de archivos, puedes hacer clic derecho sobre el archivo y verás una opción para cambiar sus permisos.
Paso 3: Establece los permisos correctos
Los permisos recomendados para wp-config.php son 644 (el propietario puede leer y escribir, el grupo y otros solo pueden leer). En la ventana de permisos, asegúrate de que los números sean 644. Si ves algo como 600 o 400, cámbialo a 644 y guarda los cambios.
[INFO]: Si por alguna razón el servidor te pide permisos 640 o 440, también suele funcionar. Lo importante es que el servidor web (Apache, Nginx, etc.) pueda leer el archivo.
Solución 3: Crear un nuevo archivo wp-config.php desde cero
Si el archivo no existe o está dañado, puedes crearlo fácilmente. WordPress proporciona un archivo de muestra que puedes renombrar y editar.
Paso 1: Busca el archivo wp-config-sample.php
En la misma carpeta raíz de WordPress, busca un archivo llamado wp-config-sample.php. Este archivo es una plantilla.
Paso 2: Renombra el archivo
Haz clic derecho sobre wp-config-sample.php y selecciona "Renombrar". Cámbiale el nombre a wp-config.php. ¡No olvides el punto!
Paso 3: Edita el nuevo archivo wp-config.php
Ahora necesitas añadir la información de tu base de datos. Haz clic derecho sobre el nuevo wp-config.php y selecciona "Editar" o "Edit". Se abrirá un editor de texto.
Paso 4: Completa la información de la base de datos
Busca las siguientes líneas y rellénalas con los datos de tu base de datos. Si no los recuerdas, puedes encontrarlos en tu panel de control de hosting (en Syspanel, normalmente en la sección "Bases de Datos").
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'usuario_de_tu_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña_de_tu_base_de_datos' );
define( 'DB_HOST', 'localhost' ); // Normalmente es 'localhost', pero a veces puede ser otra dirección.
Paso 5: Guarda los cambios y cierra el editor
Una vez que hayas introducido los datos correctos, guarda el archivo (normalmente Ctrl+S o Cmd+S) y cierra el editor.
[WARNING]: Asegúrate de que la información de la base de datos sea exacta. Un error aquí hará que tu web no funcione correctamente.
Solución 4: Revisar el archivo .htaccess
Un archivo .htaccess corrupto o mal configurado puede causar este error.
Paso 1: Localiza el archivo .htaccess
En la misma carpeta raíz de WordPress, busca el archivo .htaccess. Es un archivo oculto, así que asegúrate de tener activada la opción "Mostrar archivos ocultos".
Paso 2: Renómbralo temporalmente
Para probar si este es el problema, renombra el archivo .htaccess a algo como .htaccess_old. Si el error desaparece, entonces el .htaccess original estaba causando el problema.
Paso 3: Genera un nuevo .htaccess (opcional)
Si renombrar el archivo solucionó el error, puedes generar uno nuevo. Ve a tu panel de administración de WordPress (si puedes acceder) y ve a Ajustes > Enlaces permanentes. Simplemente haz clic en "Guardar cambios" y WordPress generará un nuevo .htaccess limpio.
Solución 5: Comprobar la ruta de instalación (si moviste WordPress)
Si has movido tu instalación de WordPress de una carpeta a otra (por ejemplo, de public_html/miweb a public_html), es posible que la ruta en el archivo wp-config.php no se haya actualizado.
Paso 1: Edita el archivo wp-config.php
Sigue los pasos de la Solución 3 para editar el archivo.
Paso 2: Busca la línea ABSPATH
Dentro del archivo, busca una línea similar a esta:
define( 'ABSPATH', dirname(__FILE__) . '/' );
Esta línea define la ruta absoluta a la carpeta de WordPress. Normalmente, dirname(__FILE__) se ajusta automáticamente, pero a veces puede quedar desactualizada.
Paso 3: Si es necesario, define la ruta manualmente
Si la línea automática no funciona, puedes definir la ruta manualmente. Por ejemplo, si WordPress está en public_html, la línea sería:
define( 'ABSPATH', '/home/usuario/public_html/' );
Importante: Necesitas conocer la ruta completa del servidor. Puedes pedírsela a tu proveedor de hosting o encontrarla en el panel de control.
Solución 6: Forzar la lectura del archivo con un plugin (Solución avanzada)
Si ninguna de las soluciones anteriores funciona, puedes intentar forzar la lectura del archivo wp-config.php mediante un pequeño código. Esta solución es un poco más técnica, pero no te preocupes, te la explico paso a paso.
Paso 1: Crea un archivo PHP temporal
En la raíz de tu WordPress, crea un nuevo archivo llamado test-config.php. Puedes hacerlo desde el File Manager.
Paso 2: Edita el archivo y pega el siguiente código
<?php
require_once( 'wp-config.php' );
echo 'El archivo wp-config.php se ha cargado correctamente.';
?>
Paso 3: Accede a este archivo desde tu navegador
Ve a tudominio.com/test-config.php. Si ves el mensaje "El archivo wp-config.php se ha cargado correctamente.", significa que el archivo existe y es legible. El problema entonces está en otro lugar (probablemente en el .htaccess o en la configuración del servidor).
[WARNING]: No olvides eliminar este archivo de prueba después de verificar.
Preguntas frecuentes (FAQ) sobre el error "wp-config.php not found"
P: ¿Puedo perder mi contenido si soluciono este error?
R: No, el error "wp-config.php not found" no afecta a tu base de datos ni a tus archivos multimedia. Tu contenido está seguro. El problema es solo de configuración.
P: ¿Qué hago si no encuentro el archivo wp-config-sample.php?
R: Si no tienes el archivo de muestra, puedes descargar una nueva copia de WordPress desde wordpress.org y extraer el archivo wp-config-sample.php de la carpeta. Luego, súbelo a tu servidor y renómbralo.
P: ¿Los permisos 644 son siempre los correctos?
R: En la mayoría de los casos, sí. Sin embargo, algunos entornos de hosting pueden requerir permisos 640 o 440. Si 644 no funciona, prueba con esos valores.
P: ¿Puedo usar un cliente FTP para hacer estos cambios?
R: Sí, absolutamente. Puedes usar FileZilla, Cyberduck o cualquier otro cliente FTP para acceder a los archivos de tu servidor y realizar las mismas acciones (renombrar, editar, cambiar permisos). El proceso es idéntico.
P: Después de seguir todos los pasos, el error sigue apareciendo. ¿Qué hago?
R: Si has probado todas las soluciones y el error persiste, es posible que el problema esté en la configuración del servidor web (Apache, Nginx) o en un firewall. En ese caso, te recomiendo contactar con el soporte técnico de tu hosting. Ellos podrán revisar los logs del servidor y encontrar la causa raíz. Diles que has seguido esta guía y que el error "wp-config.php not found" sigue apareciendo.
Espero que esta guía te haya sido de gran ayuda. Recuerda que los errores en WordPress son más comunes de lo que crees y, con un poco de paciencia y siguiendo estos pasos, casi siempre tienen solución. ¡No dudes en volver a consultarme si tienes alguna otra duda! ¡Mucho ánimo!
