PHP数据库连接测试方法详解

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《PHP数据库命令行连通性测试方法》，聊聊，希望可以帮助到正在努力赚钱的你。

用 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 -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学习网公众号了解相关技术文章。