Introducción al Error MySQLi Connection Refused en PHP
Uno de los problemas más frustrantes a los que nos enfrentamos los desarrolladores web al trabajar con bases de datos relacionales es el error de conexión en PHP utilizando MySQLi. Este fallo interrumpe por completo la ejecución de la aplicación, mostrando normalmente un mensaje que indica que la conexión fue rechazada o que no se pudo establecer comunicación con el servidor de base de datos.
Causas Principales del Error
- El servicio del servidor MySQL o MariaDB no está en ejecución.
- Las credenciales de acceso (host, usuario, contraseña o puerto) son incorrectas en el archivo de configuración de PHP.
- Restricciones del cortafuegos (firewall) o configuración de red que bloquean el puerto predeterminado (3306).
- El socket de conexión local no está correctamente configurado en entornos de desarrollo local como XAMPP, MAMP o WampServer.
Método 1: Verificar el Estado y el Puerto del Servidor MySQL
Lo primero que debemos hacer es comprobar si el motor de la base de datos está encendido y accesible. Si estás en un entorno Linux, abre tu terminal y ejecuta el siguiente comando:
sudo systemctl status mysqlSi el servicio está detenido, inícialo con:
sudo systemctl start mysqlEn entornos de desarrollo local como Windows, asegúrate de iniciar el módulo de MySQL desde el panel de control de XAMPP o WampServer. Además, verifica que el puerto configurado en tu script PHP coincida con el puerto real del servidor (por defecto, 3306).
Método 2: Validar las Credenciales en la Conexión PHP
Un error común es pasar parámetros erróneos en la función mysqli_connect(). Revisa minuciosamente tu código fuente y asegúrate de que el host, el usuario y la contraseña sean exactamente los correctos:
$conexion = mysqli_connect('localhost', 'usuario_db', 'contraseña_db', 'nombre_db');
if (!$conexion) {
die('Error de depuración: ' . mysqli_connect_error());
}Si estás conectando desde un contenedor Docker o un servidor remoto, recuerda cambiar localhost por la dirección IP correspondiente o el nombre del servicio asignado en la red interna.
Método 3: Revisar Permisos de Usuario en la Base de Datos
A veces el servidor acepta la conexión, pero rechaza al usuario específico debido a falta de privilegios o restricciones de host (por ejemplo, permitir solo conexiones desde localhost). Conéctate como administrador a tu gestor de base de datos y ejecuta la siguiente consulta SQL para otorgar los permisos necesarios:
GRANT ALL PRIVILEGES ON nombre_db.* TO 'usuario_db'@'localhost' IDENTIFIED BY 'contraseña_db';
FLUSH PRIVILEGES;Tras aplicar estos pasos, recarga tu aplicación web en el navegador y el error de conexión MySQLi debería haber desaparecido por completo.