thinkphp的database.php配置需严格遵循结构：default必须匹配connections中真实键名，connections是唯一生效区域，敏感信息须用env()读取，ssl参数只能通过params数组以pdo常量+绝对路径配置。
ThinkPHP 的 config/database.php 不是“填完就能用”的普通配置文件，它是一套有严格结构、键名敏感、层级分明的连接定义机制。写错一个顶层键，整个配置就静默失效；漏掉一个 env()，.env 修改等于白改；SSL 路径写成相对路径，连上也查不到证书——这些坑，都在逐行细节里。
default 必须指向 connections 里的真实键名
'default' => 'mysql' 这一行看似简单，实则关键：它的值必须和 connections 数组中某个子项的键名完全一致（比如 'mysql' 或 'user_db'），不能是驱动类型（如 'pdo_mysql'），也不能是空字符串或任意字符串。否则框架找不到默认连接，报错 Connection not found。
- ✅ 正确：
'default' => 'master'，且connections中存在'master' => [...] - ❌ 错误：
'default' => 'mysql'，但connections里只有'primary'和'slave' - ⚠️ 注意：default 只决定 Db::table() 这类无参调用走哪个连接，不参与多库切换逻辑
connections 是唯一真正生效的连接定义区
所有数据库连接都必须放在 'connections' 这个关联数组下，每个子项是一个完整连接配置。框架只认这个键下的内容，其他位置写的 'hostname'、'database' 等字段，如果不在 connections 某个子项里，一律被忽略。
- 每个连接必须含
'type'（如'mysql'）、'hostname'、'database'、'username'、'password' -
'hostport'建议显式写，避免依赖 PDO 默认端口（MySQL 是 3306，但 PostgreSQL 是 5432） -
'charset'强烈设为'utf8mb4'，防止 emoji 存储异常 -
'prefix'可为空字符串，但不要省略，否则可能触发意外表名拼接
敏感字段必须用 env() 读取，默认值仅作开发兜底
密码、主机、端口这些参数，绝不能硬编码在 database.php 里。必须通过 env('DB_PASSWORD', 'root') 这种方式加载，并确保 .env 文件存在且格式正确。
- .env 文件要放在项目根目录，变量全大写+下划线，如
DB_HOST=192.168.1.100 - 等号两侧不能有空格，否则
env()返回 null，导致连接拒绝（SQLSTATE[HY000] [1045]） - 修改 .env 后必须执行
php think clear:config，否则缓存仍用旧值 - CLI 模式下需确认
think\Env::load()已调用，否则env()返回 null
SSL 和底层参数只能塞进 params 数组
想启用 MySQL SSL？别往 DSN 字符串里拼 ?ssl_mode=REQUIRED，ThinkPHP 不解析它。唯一有效路径是 'params' 数组，且必须用 PDO 常量 + 绝对路径。
- 证书路径必须是绝对路径，如
PDO::MYSQL_ATTR_SSL_CA => '/etc/ssl/mysql/ca.pem' - 服务端要求双向认证时，还需提供
PDO::MYSQL_ATTR_SSL_CERT和PDO::MYSQL_ATTR_SSL_KEY - SSL 模式必须用整数常量：
PDO::MYSQL_ATTR_SSL_MODE_REQUIRED，写字符串'REQUIRED'会被忽略 - 持久连接、超时等也走
params，例如PDO::ATTR_PERSISTENT => true
不复杂但容易忽略——每一行都在执行校验，每一对引号都在影响连接成败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
