phpEnv如何配置PHP连接非标准端口的MySQL？

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《phpEnv如何配置PHP连接非标准端口的MySQL？》，聊聊，我们一起来看看吧！

mysqli连非标端口必须用127.0.0.1作$host并单独传int型$port参数，不可在host中拼接冒号端口；PDO则需在DSN中严格按mysql:host=;port=;dbname=顺序写入。

mysqli 连非标端口必须传整数 $port 参数，且 $host 不能是 localhost

phpEnv 默认用 mysqli 连 MySQL，但如果你的 MySQL 实例监听在 3307、4306 等非标端口，直接写 "localhost:3307" 会失败——mysqli_connect() 不解析 host 字符串里的冒号端口。

正确做法是：

• $host 改成 "127.0.0.1"（强制走 TCP，绕过 Unix socket）
• $port 单独作为第 4 个参数传入，且必须是整数类型（比如 3307，不是 "3307"）
• 前 3 个参数（host/user/pass）不能省略，否则第 4 个参数会被当成 socket 路径

示例：

$host = "127.0.0.1";
$user = "root";
$pass = "123456";
$db   = "test";
$port = 3307; // 注意：这里是 int，不是 string

$conn = mysqli_connect($host, $user, $pass, $db, $port);
if (!$conn) {
    die("Connect Error: " . mysqli_connect_error());
}

PDO 的 DSN 中 port= 必须紧接 host= 后、dbname= 前

phpEnv 里若用 PDO（比如 Laravel、ThinkPHP 默认），DSN 写法稍严：端口不是 URL 风格的 @host:port/，而是标准键值对，顺序错一位就失效。

常见错误包括：

• 漏掉 host=（哪怕值是 127.0.0.1），只写 port=3307 → 连接失败
• 把 port=3307 放在 dbname= 后面 → 被忽略，仍连 3306
• 写成 mysql://root:123@127.0.0.1:3307/test → PDO 不支持这种 URL 格式，直接抛异常

正确 DSN 示例：

$dsn = "mysql:host=127.0.0.1;port=3307;dbname=test;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
]);

phpEnv 的配置文件（如 php.ini 或框架配置）不控制 MySQL 端口

别指望改 php.ini 里的 mysql.default_port 或类似项能让所有连接自动走新端口——这个 ini 设置仅影响极老的 mysql_* 函数（已废弃），对 mysqli 和 PDO 完全无效。

真实生效点只有两个：

• 代码里显式传参（mysqli_connect 的第 4 个参数 / PDO DSN 的 port=）
• MySQL 客户端工具（如 phpEnv 自带的 mysql 命令）靠 -P 参数或 [client] 段配置

如果你在 phpEnv 里用命令行执行 mysql -u root -p 连不上，记得加 -P 3307；或者编辑 /usr/local/phpenv/etc/my.cnf，在 [client] 下加一行：port = 3307。

测试端口通不通，telnet 只能算第一步

telnet 127.0.0.1 3307 成功，只说明 TCP 层通了，不代表 MySQL 服务真在监听该端口或接受连接。

真正要验证，得用 MySQL 客户端直连：

• 运行 mysql -h 127.0.0.1 -P 3307 -u root -p，看是否弹密码提示
• 如果报 Access denied，说明服务起来了，只是权限问题；如果报 Connection refused，才是端口没监听或防火墙拦了
• phpEnv 环境下，还要确认 MySQL 是否绑定了 127.0.0.1（而非仅 localhost 或 ::1），bind-address 配置在 my.cnf 的 [mysqld] 段里

最容易被忽略的是：Docker 或 WSL 场景下，宿主机 127.0.0.1:3307 映射到容器内 3306，此时 PHP 代码里填的仍是宿主机端口（3307），不是容器内端口（3306）。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~