ThinkPHP8如何连接MySQL数据库？_ThinkPHP8连接MySQL配置方法【实战】-ThinkPHP-PHP中文网

thinkphp8连接mysql需同时满足四项前提：mysql服务运行、认证插件改为mysql_native_password、php启用pdo_mysql扩展、database.php中hostname必须用127.0.0.1而非localhost，缺一即报access denied或connection refused。

thinkphp8如何连接mysql数据库？_thinkphp8连接mysql配置方法【实战】

ThinkPHP8 能连上 MySQL 的前提，不是改完 database.php 就完事，而是 MySQL 服务本身在跑、认证方式兼容、PHP 扩展已启用、配置里没写错关键参数——漏掉任意一环，都会卡在「Access denied」或「Connection refused」。

MySQL 8.0 默认认证插件不兼容 PHP 旧驱动

MySQL 8.0+ 默认用 caching_sha2_password，而多数 PHP 环境（尤其 phpEnv 或低版本 PHP）只认 mysql_native_password。不改它，root@localhost 就永远被拒绝。

进 MySQL 命令行（mysql -u root -p），执行：
```
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '';
```
（密码为空就留空，有密码就填你设的）
执行 FLUSH PRIVILEGES;
确认改成功：
```
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
```
结果里 plugin 列必须是 mysql_native_password

ThinkPHP8 的 database.php 配置必须显式指定 127.0.0.1

别写 localhost——Windows 下它可能走命名管道或 IPv6 回环，导致连接超时或报错 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

路径是 config/database.php（TP8.0+ 不再默认读 .env，除非你手动加了 dotenv 支持）

关键几项必须这样写：

'hostname' => '127.0.0.1',<br>'hostport' => 3306,<br>'username' => 'root',<br>'password' => '', // phpEnv 默认无密码，改过就填改后的<br>'database' => 'test_db', // 必须是已创建的库名，否则启动时报 Unknown database

db_type 或 type 设为 'mysql'，别漏

先甩开框架，用原生 mysqli 验证底层通不通

别一上来就跑 php think migrate 或访问页面——框架报错信息常掩盖真实原因。最小闭环验证最省时间。

在网站根目录建 test_db.php，内容：

<?php <br>$mysqli = new mysqli('127.0.0.1', 'root', '', 'test_db', 3306);<br>if ($mysqli->connect_error) {<br>    die('Connect Error: ' . $mysqli->connect_error);<br>}<br>echo 'OK, MySQL is reachable';<br>$mysqli->close();<br>?>

浏览器直接访问 http://your-site/test_db.php，输出 OK, MySQL is reachable 才算过关
如果失败，错误信息就是真实瓶颈：Connection refused → MySQL 没启动；Access denied → 认证或密码错；Unknown database → 库不存在

phpEnv 用户务必确认 MySQL 服务状态和端口占用

很多人改完配置死活连不上，其实 phpEnv 界面里 MySQL8 显示的是「未启动」或「启动中」——它根本没跑起来。

打开 phpEnv 主界面，看「服务状态」栏，MySQL8 必须是绿色「已启动」，不是灰色或黄色
若点「启动」失败，去日志里搜 Can't start service 或 Address already in use，大概率是 3306 被 Navicat、Docker、另一个 MySQL 实例占了
命令行验证是否真通：mysql -u root -p 回车后直接敲回车（空密码）或输你设的密码，能进 MySQL 提示符就说明服务层 OK

真正卡住人的地方，往往不是配置语法，而是 MySQL 认证方式、localhost 解析行为、服务实际运行状态这三者之一没对齐。每次连不上，先跑 test_db.php，再查 plugin，最后盯一眼 phpEnv 界面右下角的服务状态——比反复改配置快得多。