ThinkPHP5如何连接MySQL数据库？_ThinkPHP5连接MySQL配置详解【经典】

ThinkPHP5 连接 MySQL 数据库，其实核心就一条——把 database.php 搞定，再确认 PDO MySQL 扩展已经启用了，基本就稳了。其他那些“连不上”的幺蛾子，十有八九是出在配置键名写错了、type 值大小写不对、或者扩展压根没开这三件事上。

先说几个核心判断，免得大家走弯路。

database.php 配置项必须写对哪些字段？

但可别以为填完就万事大吉了——ThinkPHP5 对几个关键键名的校验相当严格。你要是漏了一个，或者拼错一个字母，Db::connect() 要么直接甩你一个 Connection not found，要么就安安静静地失败，连个响都没有。

• type 必须写成小写的 'mysql'，别写成 'MySQL'、'Mysql' 或者 'pdo_mysql'，否则框架压根不认。
• hostname、database、username、password 这四个字段，一个都不能少。至于 hostport，默认是 3306，你要是没改端口可以省掉，但改了就必须写上。
• charset 强烈建议设置成 'utf8mb4'，别再用 'utf8' 了，不然 emoji 那些字符存进去会出问题。
• params 里头一定要带上 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，不然错误不抛出，你调试起来就像大海捞针，特别痛苦。

Db::connect() 传参常见错误类型

不少新手想当然，以为传个数据库名、模型名甚至 DSN 字符串过去就能连上。实际上完全不是那么回事。

• 传字符串的时候，只认 database.php 里定义好的连接键名，比如 'mysql_write'。你传个 'app_main' 或者 'User'，框架表示不认识。
• 传数组的话，必须带上 'type' => 'mysql'，而且其他字段名一定要和配置文件里的一致。比如不能把 'hostname' 写成 'host'，否则就找不着北了。
• 万一你要传 DSN 字符串，格式必须是 mysql://user:pass@host:port/db#charset，中间不能有空格，# 后面只能跟编码名，多写个其他符号都不行。
• 最后，千万别图省事传 Db::connect('default')，除非你确实在 database.php 里定义了一个名叫 'default' 的连接键。

为什么连得上但查不出数据？检查这三处

配置没报错，Db::connect() 也返回了对象，结果一执行 ->select()，要么返回空数组，要么提示字段不存在。这时候别急着怀疑 SQL 写错了，底层配置可能悄悄被忽略了。

• prefix 这个配置项，你要是设了但表名没加前缀，或者一不小心加了两次前缀（比如配置里写了 'prefix' => 'tp_'，又在代码里写 ->table('tp_user')），那查出来的数据肯定会出问题。
• fields_strict 默认是 true，这意味着数据库字段名和查询语句里的大小写必须完全一致。比如数据库里是 user_id，你代码里写成了 userId，那大概率会返回空结果。
• 当你用 Db::connect('mysql_read') 获取实例后，直接链式调用 ->table('user')->select() 是没问题的。但要是中间又去折腾别的 Db 操作，那这个连接实例不会自动复用，每次都得重新 connect 一遍。这一点容易忘，值得留意。

多环境切换最容易漏掉的点

用 .env 文件管理配置的时候，database.php 里必须用 env('DB_HOST', '127.0.0.1') 这种方式去读取，不能把配置写死。

• env() 函数只在应用启动时解析一次。要是你修改了 .env 文件，记得清空 runtime/cache/ 目录，否则旧配置还是会生效，让你白折腾半天。
• 需要注意，DB_TYPE 是 ThinkPHP 3 时代的旧键名了，TP5+ 已经废弃。如果你写成 'type' => env('DB_TYPE')，却又没在 .env 里定义 DB_TYPE，那 type 就会变成 null。最后框架会拿默认的 MySQL 驱动去解析 PostgreSQL 的配置，报个 Class 'PDO' not found 的错误，让你摸不着头脑。
• 测试环境开了 debug => true，生产环境关掉了，但别忘了顺手关掉 sql_explain。不然上线后慢查询日志会暴增，影响性能。

这里最让人头疼的一类问题其实是“看起来连上了，但行为不对”。比如读写分离配置里漏了 'write_master' => false，或者多个连接共用了同一个 hostname 却没改 database。这种问题不会报错，只会让你花上大把时间怀疑人生。所以说，配置这事，真得仔细再仔细。