CentOS上PHP数据库连接问题解决方案

在CentOS环境下运行PHP应用，数据库连接问题确实容易遇到。问题本身不一定复杂，但排查顺序如果搞反了，往往白费功夫。下面按照常见问题的排查步骤逐一说明，按顺序操作基本能覆盖大多数场景。

1. 确认数据库服务是否运行

第一步，先确认数据库服务是否正常运行。无论是MySQL还是MariaDB，服务没启动，连接必然失败。执行以下命令检查状态：

sudo systemctl status mysqld

如果返回状态为"未运行"，启动服务：

sudo systemctl start mysqld

2. 确认PHP扩展是否安装

数据库服务正常，PHP这边也需要安装对应的扩展。例如连接MySQL，需要安装php-mysql或php-mysqlnd，具体取决于PHP版本——低版本用前者，7.x及更高版本推荐后者。

sudo yum install php-mysql

或者

sudo yum install php-mysqlnd

扩展安装完成后，重启Web服务器使配置生效：

sudo systemctl restart httpd

如果是Nginx：

sudo systemctl restart nginx

3. 检查数据库连接配置

代码中的连接参数需要逐一核对：主机名、用户名、密码、数据库名称。参数写错自然无法连接。常见误区是主机名写"localhost"但MySQL配置要求"127.0.0.1"或相反，这一点值得留意。

connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
?>

4. 检查防火墙设置

CentOS自带防火墙若未放行数据库端口（默认3306），连接请求会被直接拦截。解决方案是添加一条放行规则：

sudo firewall-cmd --zone=public --add-port=3306/tcp --permanent
sudo firewall-cmd --reload

5. 检查SELinux设置

如果以上步骤均无问题，SELinux可能在背后限制数据库访问。可以临时关闭SELinux进行测试：

sudo setenforce 0

如果问题消失，则应配置SELinux规则以允许PHP访问数据库（不建议直接关闭SELinux）。

6. 检查错误日志

最后一种最直接的方法——查看日志。PHP和数据库各自都有错误日志文件，关键信息往往就在里面。

PHP错误日志通常位于：/var/log/php-fpm/error.log 或 /var/log/httpd/error_log。
MySQL错误日志位于：/var/log/mysqld.log。

sudo tail -f /var/log/php-fpm/error.log
sudo tail -f /var/log/mysqld.log

按照上述顺序逐一排查，大部分CentOS下PHP数据库连接问题都能找到根源。如果仍无法解决，请提供具体的错误信息，顺着线索继续追查会更有效率。