PHP连接MySQL失败需依次排查：一、确认MySQL服务运行；二、核对连接参数（主机、端口、凭据）；三、检查用户权限与Host绑定；四、排除防火墙/SELinux拦截；五、确保mysqli或pdo_mysql扩展已启用。
如果在PHP脚本中尝试连接MySQL数据库时出现错误，通常表现为mysqli_connect()或PDO::__construct()调用失败，并返回类似“Connection refused”、“Access denied”或“Unknown database”等提示。以下是针对该问题的多种排查与修复方法：
一、检查数据库服务是否运行
PHP无法连接MySQL的根本前提之一是MySQL服务未启动，此时连接请求会被系统直接拒绝。
1、在Linux服务器上执行命令 sudo systemctl status mysql 或 sudo service mysqld status 查看服务状态。
2、若显示 inactive，则运行 sudo systemctl start mysql 启动服务。
立即学习“PHP免费学习笔记（深入）”；
3、在Windows环境下，打开“服务”管理器，查找名为 MySQL80 或 MySQL 的服务，确认其状态为“正在运行”。
二、验证连接参数是否正确
PHP连接语句中使用的主机地址、端口、用户名、密码及数据库名必须与MySQL实际配置完全一致，任一字段错误均会导致连接失败。
1、确认PHP代码中使用的主机名不是 localhost（该值在部分系统中会强制走Unix socket），可尝试替换为 127.0.0.1 强制使用TCP/IP协议。
2、检查端口号是否为MySQL实际监听端口，默认为 3306；若修改过配置，需同步更新PHP连接字符串中的 port 参数。
3、使用命令行工具手动验证凭证：执行 mysql -u 用户名 -p -h 127.0.0.1 -P 3306，输入密码后观察是否能成功登录。
三、确认用户权限与主机绑定规则
MySQL用户账户不仅需存在，还必须被授权从PHP所在主机（可能是本地或远程）访问指定数据库，且账号未被限制来源IP或域名。
1、登录MySQL后执行 SELECT User, Host FROM mysql.user; 查看当前用户列表及其允许连接的Host值。
2、若PHP运行在本机但用户Host列为 localhost，而连接时使用的是 127.0.0.1，则可能因MySQL对二者视为不同主机而拒绝连接；此时应创建Host为 127.0.0.1 或 % 的同名用户。
3、执行 GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'%' IDENTIFIED BY '密码'; FLUSH PRIVILEGES; 授予必要权限并刷新权限表。
四、检查防火墙与SELinux限制
即使MySQL服务运行正常且凭据无误，网络层拦截也可能导致连接超时或被拒绝，尤其在云服务器或企业内网环境中常见。
1、在Linux服务器上运行 sudo ufw status（Ubuntu）或 sudo firewall-cmd --list-all（CentOS/RHEL）查看防火墙是否放行3306端口。
2、如未放行，执行 sudo ufw allow 3306 或 sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload 开启端口。
3、对于启用SELinux的系统，运行 sudo setsebool -P httpd_can_network_connect_db 1 允许Web服务器进程连接数据库。
五、验证PHP扩展是否启用
PHP需加载对应数据库驱动扩展（如mysqli或pdo_mysql）才能发起连接请求，缺少扩展将导致函数未定义或连接机制不可用。
1、在PHP脚本中插入 var_dump(extension_loaded('mysqli')); 或 var_dump(extension_loaded('pdo_mysql')); 检查扩展是否已加载。
2、若返回false，编辑php.ini文件，取消以下行的注释：extension=mysqli 和/或 extension=pdo_mysql（Windows下为 extension=php_mysqli.dll 等）。
3、保存php.ini后重启Web服务器（如Apache执行 sudo systemctl restart apache2，Nginx+PHP-FPM则执行 sudo systemctl restart php-fpm）。
