php不监听数据库端口,真正需排查的是mysql服务监听状态:先用ss -tlnp | grep :3306确认是否监听,若无输出则未监听;有输出需核对bind-address与port配置一致并重启服务,php连接时须显式传入正确端口号。

PHP 8.5.5 本身不监听数据库端口,它只是客户端 —— 真正要查的是 MySQL(或其他 DB)服务监听的端口,不是 PHP 的。
确认 MySQL 实际监听哪个端口
Connection refused 错误里,60% 以上是 MySQL 根本没在你写的端口上监听。别改 PHP 代码,先看服务端。
- Linux/macOS 执行:
ss -tlnp | grep :3306(或换为你要查的端口,如:3307);无输出 = 没监听该端口 - 若看到
127.0.0.1:3306,表示只接受本地 TCP 连接;*:3306或0.0.0.0:3306才支持远程(含本机其他进程) - macOS 上 Homebrew 启动的 MySQL 有时默认走 Unix socket 而非 TCP,此时
lsof -i :3306可能无结果 —— 那就得去查my.cnf里有没有skip-networking或bind-address = localhost
检查 MySQL 配置中 port 和 bind-address 是否一致
这两个配置必须协同生效,否则“服务在跑,但连不上”。
- 找真实生效的配置文件:
mysql --help | grep "Default options",常见路径有/etc/mysql/my.cnf、/opt/homebrew/etc/my.cnf -
[mysqld]段下必须有未注释的port = 3306(或你设的值) -
bind-address不能是localhost(它会强制走 socket),得是127.0.0.1(仅本地 TCP)或0.0.0.0(全网卡) - 改完必须
systemctl restart mysql或brew services restart mysql——reload不重读端口配置
PHP 连接时端口参数不能依赖默认值
mysqli_connect() 第 5 个参数 $port 是可选的,但只要 MySQL 改了端口,它就变成必填项。漏掉或传错位置,PHP 就 fallback 到 3306,直接 Connection refused。
- 错误写法:
mysqli_connect('127.0.0.1', 'root', 'pass', 'test')→ 默认连 3306,但 MySQL 其实在 3307 - 正确写法:
mysqli_connect('127.0.0.1', 'root', 'pass', 'test', 3307) - PDO 更容易错:
mysql:host=127.0.0.1;port=3307;dbname=test——port键名不能拼错,也不能漏掉
用 PHP 自己测端口通不通(辅助验证)
不是查“PHP 的端口”,而是用 PHP 去探测目标数据库 IP+端口是否可达。适合部署后快速验证网络链路。
- 用
fsockopen()最直接:fsockopen('127.0.0.1', 3307, $errno, $errstr, 2),返回 resource 表示通,false 表示拒绝或超时 - 封装成函数更方便调试:
checkPortStatus('127.0.0.1', 3307),超时建议设 1–2 秒,避免阻塞 - 注意:这个测试只反映 TCP 层连通性,不代表 MySQL 服务就健康 —— 连上了也可能因认证失败、权限不足而被断开
最容易被忽略的一点:开发环境里常把 Web 服务器端口(比如 8080)和 MySQL 端口(3306)搞混,以为“我在访问 :8080,那数据库也得配 8080”。MySQL 端口和 Web 服务端口完全无关,必须单独确认并匹配。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











