PHP配置MySQL端口设置教程

本文详解了PHP本地开发环境中MySQL端口冲突的典型问题与完整解决方案：从如何快速检测3306端口是否被Skype、Docker或残留服务占用，到精准定位并修改不同安装方式（XAMPP/MAMP/Homebrew等）下的MySQL配置文件（my.cnf/my.ini）中[mysqld]段的port参数，再到关键提醒——PHP连接时必须使用127.0.0.1而非localhost才能真正走TCP并生效新端口，最后提供终端直连验证和错误码诊断技巧，帮你避开socket/TCP混淆、配置未重载、服务未重启等高频坑点，真正实现一步到位的端口切换。

MySQL 默认端口是 3306，改端口前先确认是否被占用

本地启动 MySQL 失败、PHP 连不上数据库，十有八九是端口冲突。Windows 上常见被 Skype、某些杀毒软件或另一个 MySQL 实例占着 3306；macOS/Linux 则可能被 Homebrew 启动的旧服务或 Docker 容器占用。

• 查端口占用（Windows）：netstat -ano | findstr :3306，再用 tasklist | findstr "PID" 看进程名
• 查端口占用（macOS/Linux）：lsof -i :3306 或 sudo ss -tulpn | grep :3306
• 别直接 kill 进程，先判断是不是你真不需要的服务——比如 Skype 默认会抢 3306，可在其设置里关掉“使用端口作为替代”

修改 MySQL 配置文件中的 port 参数

PHP 本身不配端口，它靠连接时指定的端口找 MySQL。真正要改的是 MySQL 的配置文件（my.cnf 或 my.ini），位置因安装方式而异：

• XAMPP：路径通常是 C:\xampp\mysql\bin\my.ini（Windows）或 /Applications/XAMPP/etc/my.cnf（macOS）
• MAMP：Windows 是 C:\MAMP\conf\my.cnf，macOS 是 /Applications/MAMP/conf/my.cnf
• 手动编译/Homebrew：配置文件可能在 /etc/my.cnf、/usr/local/etc/my.cnf 或 $(brew --prefix mysql)/my.cnf
• 找到 [mysqld] 段，在下面加一行：port = 3307（或其他未被占用的端口）
• 改完必须重启 MySQL 服务，否则不生效；XAMPP/MAMP 界面点“Restart”即可，命令行用 sudo brew services restart mysql 或 sudo systemctl restart mysql

PHP 连接时显式指定新端口，不能只靠 localhost

很多人以为改了 MySQL 配置就万事大吉，结果 PHP 还是连不上——因为 localhost 在 MySQL 协议里有特殊含义：它强制走 socket 文件（Unix domain socket），**完全忽略端口设置**。

• 正确做法是把主机名从 localhost 换成 127.0.0.1，这样才会走 TCP/IP 并读取你设的端口
• PDO 连接示例：

  $pdo = new PDO('mysql:host=127.0.0.1;port=3307;dbname=test', 'root', '');

• mysqli 连接示例：

  $mysqli = new mysqli('127.0.0.1', 'root', '', 'test', 3307);

• 如果用 mysql_connect()（已废弃，别用），也必须传第 4 个参数 $port

验证端口是否生效，别只信 PHP 报错

PHP 报 “Connection refused” 不一定代表端口没开，可能是 MySQL 根本没起来，或防火墙拦了。最稳的验证方式是绕过 PHP 直接测 MySQL 本身：

• 终端执行：mysql -h 127.0.0.1 -P 3307 -u root -p（注意 -P 是大写，小写 -p 是密码）
• 如果能进 MySQL 命令行，说明服务、端口、权限全 OK；如果报 Can't connect to MySQL server，重点检查 MySQL 是否运行、配置是否 reload、端口是否拼错
• PHP 中可用 mysqli_connect_error() 或 PDO::errorInfo() 看具体错误码，比如 2003 是连接失败，1045 是权限问题，二者处理方式完全不同

改端口不是难事，但容易卡在「以为改了配置就完了」这一步。socket 和 TCP 的行为差异、配置文件路径混乱、服务未真正重启——这些才是本地环境里最常耽误半天的地方。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP配置MySQL端口设置教程》文章吧，也可关注golang学习网公众号了解相关技术文章。