在phpEnv中如何配置ThinkPHP以连接MySQL数据库？

本文共计965个文字，预计阅读时间需要4分钟。

非常抱歉，您提供的信息似乎不完整。为了更好地帮助您，请提供完整的句子或段落，我将根据您的要求进行改写。

为什么 phpEnv 里必须用 127.0.0.1 而不是 localhost

MySQL 在 Windows 下对 localhost 有特殊处理：它会尝试走命名管道或 socket，而 phpEnv 默认只启用 TCP/IP。你看到的 SQLSTATE[HY000] [2002] Connection refused 错误，基本就是这个原因。

• DB_HOST=localhost → PHP 尝试连接 MySQL 的 socket 文件（但 phpEnv 没配或路径不对）
• DB_HOST=127.0.0.1 → 明确走 TCP/IP，绕过 socket 问题
• 即使 MySQL 服务在本机，也别信“localhost 更快”——在 phpEnv 场景下它大概率直接失败

.env 配置优先级和常见覆盖陷阱

ThinkPHP 6/8 启用 .env 后，config/database.php 里的 connections.mysql.hostname 等字段会被完全忽略——哪怕你只改了 .env 里一个键，整个连接配置都以它为准。

• 确认 .env 文件位于项目根目录，且文件名是 .env（不是 .env.example 或带 BOM）
• 必须用 DB_HOST、DB_NAME、DB_USER、DB_PASS 这套命名（ThinkPHP 8 默认），不是 DB_USERNAME 或 DB_PASSWORD
• 密码含 @、/、: 等字符时，必须 URL 编码，例如 pa@ss/word → pa%40ss%2Fword
• 如果改了 .env 没生效，清空 runtime/cache/ 目录再试——ThinkPHP 会缓存配置

phpEnv 中 MySQL 服务状态与端口验证

phpEnv 控制面板显示“MySQL 已启动”，不代表端口真通。本地开发最常踩的坑是 MySQL 实际监听的是 3307 而不是默认 3306（尤其当你装过多个 MySQL 版本）。

立即学习“PHP免费学习笔记（深入）”；

• 打开 phpEnv 安装目录下的 server\mysql\mysql-8.0\my.ini，检查 port= 值（常见为 3306 或 3307）
• 命令行执行 netstat -ano | findstr :3306（把 3306 换成你配置的端口），确认有 LISTENING 状态且 PID 对应 mysqld.exe
• 用 Navicat 或 MySQL Workbench 手动连一次：主机填 127.0.0.1、端口填配置值、用户密码同 .env，能连上才说明服务没问题
• ThinkPHP 报 Connection refused 时，先跳过代码，只做这一步验证

多数据库配置时 Db::connect() 的正确调用方式

想在同一个项目里连两个库，不能靠改 .env 动态切换，必须显式声明连接名并用 Db::connect('mysql2') 获取 Query 实例。

• .env 里加第二组配置，如：DB2_HOST=127.0.0.1、DB2_NAME=gxsjk，然后在 config/database.php 的 connections 数组里补全对应项
• 控制器中写 Db::connect('mysql2')->table('user')->select()，不是 Db::connect(['hostname' => '...']) —— 后者绕过容器，事务和事件监听会失效
• 不要在模型里硬编码连接名，用 protected $connection = 'mysql2'; 更安全
• 连接名必须和 config/database.php 中 connections 的键一致，大小写敏感

真正卡住人的往往不是语法，而是 phpEnv 的 MySQL 实际监听端口、.env 的命名规范、以及 localhost 和 127.0.0.1 的底层差异——这三个点对齐了，95% 的连接问题就消失了。