排查PHP数据库连接问题，第一步永远是要找到日志在哪里。在CentOS环境下，PHP错误日志藏在哪里，主要看用的是哪种Web服务器——PHP-FPM、Apache还是Nginx，路径各有不同。

1. 定位PHP错误日志文件

先确认你使用的是哪种Web服务器。不同环境下，PHP错误日志的位置并不一样。

常见日志路径如下：

• 如果用的是PHP-FPM，去 /var/log/php-fpm/error.log 找
• Apache的话，默认在 /var/log/httpd/error_log
• Nginx则通常放在 /var/log/nginx/error.log

想快速定位问题，可以打开终端，使用 tail -f /var/log/php-fpm/error.log 实时查看日志输出。

记得替换成你实际的日志路径。这样能第一时间看到错误发生的时间点和具体类型，排查效率会高很多。

2. 分析日志中的数据库连接错误信息

日志里的报错信息通常很直接。先看错误内容，基本就能判断问题方向。

常见错误类型有以下几类：

• 连接失败类：比如“Connection refused”“Host ‘xxx’ is not allowed to connect”，或者“Can’t connect to MySQL server on ‘localhost’ (111)”。这类信息通常表示PHP想连数据库，但连接没有建立成功。
• 认证失败类：典型报错是“Access denied for user ‘root’@‘localhost’ (using password: YES)”。这一般说明用户名或密码不对。
• 扩展缺失类：如果看到“Call to undefined function mysqli_connect()”或者“Class ‘PDO’ not found”，那说明PHP还没装对应的数据库扩展。
• 超时类：比如“Maximum execution time exceeded”或“Connection timed out”，往往说明网络不通，或者数据库响应太慢。

先看报错类型，再决定下一步。通常很快就能判断是配置问题、权限问题，还是扩展没装。

3. 检查数据库配置参数

接下来，回到PHP代码里，确认数据库连接配置是否正确。

无论是用 mysqli_connect() 还是PDO的DSN，重点检查下面这些参数：

• 主机名：是 localhost 还是IP地址？如果数据库在远程服务器上，必须用IP。
• 端口：MySQL默认是 3306，如果你改过配置，代码里也要保持一致。
• 用户名和密码：区分大小写，避免手误。
• 数据库名：确保数据库确实存在，可以登录MySQL命令行用 SHOW DATABASES; 验证一下。

还可以用 phpinfo() 函数查看当前PHP加载的配置。

重点关注 mysqli.default_host 和 pdo_mysql.default_socket 这些参数是否对得上。

4. 验证数据库服务器状态

数据库服务是否正常运行，是最基础的一步。

先用下面的命令检查状态：

# 检查MySQL服务状态
sudo systemctl status mysqld
# 如果是MariaDB，命令类似

# 如果没启动，就启动它
sudo systemctl start mysqld

# 顺便设置开机自启
sudo systemctl enable mysqld

检查完服务状态后，再用 netstat -tulnp | grep 3306 确认数据库是否在正确的端口上监听。

5. 检查网络与防火墙设置

如果数据库不在本机，还需要继续检查网络和防火墙。

• 网络连通性：先试试 ping <数据库服务器IP>，看看PHP服务器和数据库服务器之间能否互通。如果不通，就需要继续排查网络问题。
• 防火墙配置：如果数据库服务器开启了防火墙，比如 firewalld 或 ufw，记得放行数据库端口。以MySQL为例：

# firewalld（CentOS 7+）
sudo firewall-cmd --permanent --add-port=3306/tcp
sudo firewall-cmd --reload

# ufw（Ubuntu）
sudo ufw allow 3306/tcp

如果数据库就在本地，可以临时关闭防火墙测试一下，例如 sudo systemctl stop firewalld。

但生产环境千万别这么干。

6. 确认PHP数据库扩展是否启用

PHP要连接数据库，必须先装好对应的扩展，比如 mysqli 或 pdo_mysql。

可以按下面几步检查：

• 打开 php.ini 文件，路径可以通过 phpinfo() 的“Loaded Configuration File”找到。
• 确认下面两行没有被注释掉，也就是前面没有 ;：

extension=mysqli.so
extension=pdo_mysql.so

• 修改完 php.ini 后，记得重启PHP服务让扩展生效：

sudo systemctl restart php-fpm   # 如果用的是PHP-FPM
sudo systemctl restart httpd     # 如果用的是Apache

• 最后，用 phpinfo() 搜索“mysqli”或“pdo_mysql”，确认扩展已经正常加载。

7. 检查数据库用户权限

连接数据库的用户，必须具备相应权限，比如 SELECT、INSERT、CONNECT 这些。

操作步骤如下：

• 登录数据库服务器：

mysql -u root -p

• 授权用户，比如允许 user1 从 localhost 连接 mydb 数据库：

GRANT ALL PRIVILEGES ON mydb.* TO 'user1'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

• 如果用户需要从远程服务器连接，可以把 localhost 换成 %，或者指定具体的IP：

GRANT ALL PRIVILEGES ON mydb.* TO 'user1'@'%' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

8. 查看数据库服务器日志

如果前面的步骤都检查过了，还是没找到问题，就去看数据库服务器自己的日志。

比如MySQL的错误日志通常位于 /var/log/mysql/error.log。这里面往往会记录更详细的失败原因。

常见信息包括“Too many connections”或“Aborted connection”。看到具体报错后，再针对性处理会更高效。