PHP数据库连通性测试命令行方法

本文详解了如何通过 PHP 命令行（php -r）一行命令快速、精准地验证 PHP 与 MySQL 的连通性，涵盖 mysqli 和 PDO 两种主流方式，并强调其在不启动 Web 服务前提下的高效调试价值；同时深入剖析了常见失败原因（如扩展未启用、MySQL 未运行、权限配置错误、socket 路径不匹配、SELinux/防火墙拦截等），给出清晰的排查路径和实用技巧（如强制使用 127.0.0.1 + 显式端口、charset=utf8mb4 必须显式声明等），帮助开发者跳过冗长脚本编写，直击问题核心，大幅提升本地环境搭建与线上故障定位效率。

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 -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 路径问题最省事。

到这里，我们也就讲完了《PHP数据库连通性测试命令行方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！