用 php -r 一行命令可快速验证 PHP MySQL 连通性:mysqli 方式为 php -r "$c = new mysqli('127.0.0.1', 'root', 'password', '', 3306); echo $c->connect_error ? 'FAIL: '.$c->connect_error : 'OK';";PDO 方式为 php -r "$d = new PDO('mysql:host=127.0.0.1;port=3306;charset=utf8mb4', 'root', 'password', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]); echo 'OK';"。

php 命令行直接测试 MySQL 连通性(不用写完整脚本)
最快速验证 PHP 是否能连上 MySQL,不是跑 Web 服务,而是用 php -r 一行命令试。关键看 PHP 是否加载了 mysqli 或 pdo_mysql 扩展,且配置没写错。
执行这行(替换你的实际参数):
php -r "\$c = new mysqli('127.0.0.1', 'root', 'password', '', 3306); echo \$c->connect_error ? 'FAIL: '.\$c->connect_error : 'OK';"如果输出 OK,说明基础连接通;若报 Class 'mysqli' not found,是扩展没启用;若报 Connection refused,大概率是 MySQL 没在运行、端口不对,或 bind-address 限制了本地连接。
pdo_mysql 方式测试(更贴近 Laravel / Symfony 等框架底层)
很多项目用 PDO,所以光测 mysqli 不够。PDO 对错误更敏感,尤其字符集和 DSN 格式稍错就直接抛异常。
立即学习“PHP免费学习笔记(深入)”;
用这个命令测:
php -r "\$d = new PDO('mysql:host=127.0.0.1;port=3306;charset=utf8mb4', 'root', 'password', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]); echo 'OK';"-
charset=utf8mb4必须显式加,否则某些环境会默认用latin1导致后续插入 emoji 报错 - 如果报
could not find driver,说明pdo_mysql扩展未启用(php -m | grep pdo查看) - 注意:PDO 默认不连接到具体库,所以 DSN 里不写
dbname=xxx是 OK 的;但如果你要测库是否存在,得补上并捕获PDOException
常见连不通的真实原因和排查顺序
别一上来就改 PHP 配置。90% 的问题出在 MySQL 侧或网络层。
- MySQL 进程是否真在跑?
systemctl status mysql或ps aux | grep mysqld - 监听地址是不是
127.0.0.1而非localhost?PHP 的mysqli对localhost会走 socket,而127.0.0.1走 TCP —— 如果 MySQL 关了 socket 或skip-networking开着,就只认后者 - 用户权限是否允许从
127.0.0.1登录?SELECT host,user FROM mysql.user;看 root 是否有127.0.0.1行,没有就CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'xxx'; GRANT ALL ON *.* TO 'root'@'127.0.0.1'; FLUSH PRIVILEGES; - SELinux 或防火墙(如 ufw)是否拦了 3306?
telnet 127.0.0.1 3306能通才说明端口层没问题
php.ini 里容易被忽略的两个配置项
即使扩展已启用,这两个设置不对也会静默失败:
-
mysqli.default_socket:如果设了但路径不存在(比如指向/var/run/mysqld/mysqld.sock,而实际在/tmp/mysql.sock),用localhost就连不上 -
pdo_mysql.default_socket:同上,PDO 也认这个;但注意它只影响localhost,不影响127.0.0.1
不确定时,统一用 127.0.0.1 + 显式 port,绕过 socket 路径问题最省事。











