PHP连不上MySQL的首要原因是mysqli或PDO_mysql扩展未启用，需检查php.ini配置并重启Web服务；其次确认MySQL进程运行、监听地址及端口开放；最后排查用户权限与认证插件兼容性。
PHP 连不上 MySQL：先确认 mysqli 或 PDO_mysql 扩展是否启用
绝大多数“连不上”的问题，根源不在密码或地址，而在 PHP 根本没加载数据库驱动。Windows 下常见于 php.ini 中扩展被注释；Linux 下则可能是扩展未安装或配置路径错误。
- 运行
php -m | grep -i mysql（Linux/macOS）或php -m（Windows 查看输出），确认列表中含mysqli和/或pdo_mysql - 若无，编辑
php.ini，取消注释对应行：;extension=mysqli
→ 改为extension=mysqli
（Windows）；Linux 常需sudo apt install php-mysql后重启 Web 服务 - 改完必须重启 Web 服务（
apache2/nginx+php-fpm），仅重启 PHP 进程无效
连接报错 Connection refused 或 Can't connect to local MySQL server
说明 PHP 尝试连接 MySQL，但 MySQL 进程未监听指定地址或端口，或被防火墙拦截。
- 先确认 MySQL 是否在运行：
sudo systemctl status mysql（Linux）或任务管理器查mysqld.exe（Windows） - 检查 MySQL 监听地址：
mysql -u root -p -e "SHOW VARIABLES LIKE 'bind_address';"。若值为127.0.0.1，则只接受本地 IPv4；若为::1，可能拒绝 IPv4 连接 —— PHP 中显式用'127.0.0.1'而非'localhost'可绕过 socket 机制 - 验证端口是否开放：
telnet 127.0.0.1 3306（Linux/macOS 可用nc -zv 127.0.0.1 3306）。失败则检查skip-networking是否被启用（my.cnf中需注释掉该行）
连接成功但提示 Access denied for user
不是密码错了，就是用户权限没给对——MySQL 8+ 默认认证插件变更，是高频踩坑点。
- 登录 MySQL 后执行：
SELECT host, user, plugin FROM mysql.user WHERE user = 'your_user';
，重点看plugin列。若为caching_sha2_password（MySQL 8.0.4+ 默认），而 PHP 版本 openssl 扩展，就会拒连 - 临时解决（开发环境）：
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
- 确保授权包含目标 host：
GRANT ALL ON *.* TO 'user'@'127.0.0.1'和GRANT ALL ON *.* TO 'user'@'localhost'是两条独立权限，不能互相替代
PHP 连接代码里最容易漏掉的三个参数
写死 localhost、忽略端口、不设字符集，这三处出错不会直接报错，但会导致中文乱码、超时或莫名断连。
立即学习“PHP免费学习笔记（深入）”；
- 显式指定端口，尤其当 MySQL 非默认 3306：
$mysqli = new mysqli('127.0.0.1', 'user', 'pass', 'db', 3307); - 连接后立即设置字符集：
$mysqli->set_charset('utf8mb4');（注意是utf8mb4，不是utf8） - 使用 PDO 时，DSN 中加入
;charset=utf8mb4，并设置PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则错误静默失败
MySQL 的权限模型和 PHP 扩展加载机制是两套独立系统，排查时别混在一起判断。一个 phpinfo() 页面就能快速定位是驱动缺失还是连接参数错，比反复改密码有效得多。
