Yii 2 中数据库连接应配置在 config/db.php 文件中，通过应用组件统一管理，而非硬编码；需确保 DSN 格式正确、MySQL 服务正常、权限充足，并注意多库配置、SQL 执行配对及参数绑定防注入。
Yii 2 中配置数据库连接的正确位置是 config/db.php
不是在控制器或模型里硬编码 new /PDO()，也不是改 index.php。Yii 2 的数据库连接由应用组件统一管理，必须通过配置文件注入。默认项目结构中，config/db.php 是专门负责返回一个数组配置的文件，内容类似：
return [
'class' => 'yii/db/Connection',
'dsn' => 'mysql:host=localhost;dbname=myapp',
'username' => 'root',
'password' => '',
'charset' => 'utf8mb4',
];
这个数组会被自动加载进 Yii::$app->db。如果改了文件名或路径，记得同步更新 config/web.php 里的 'db' => require __DIR__ . '/db.php' 这一行。
连接不上时先检查 dsn 格式和 MySQL 服务状态
常见报错如 SQLSTATE[HY000] [2002] Connection refused 或 SQLSTATE[HY000] [1045] Access denied，基本可按以下顺序排查：
-
host写成了127.0.0.1却没开 MySQL 的 TCP 绑定（Docker 环境尤其容易踩坑，试试换host为容器名或host.docker.internal） -
dbname不存在，或用户没权限 —— 用命令行手动连：mysql -u root -p -h localhost myapp -
charset设成utf8导致中文乱码或建表失败，Yii 2.0.14+ 推荐用utf8mb4 - 密码含特殊字符（如
@、/）没做 URL 编码 —— 实际要用rawurlencode()处理后再拼进dsn
Yii::$app->db 是默认连接，多库场景要显式定义组件
如果项目要同时连 MySQL 和 PostgreSQL，或者读写分离，就不能只靠一个 db。得在 config/web.php 的 'components' 里额外加：
立即学习“PHP免费学习笔记（深入）”；
'db2' => [
'class' => 'yii/db/Connection',
'dsn' => 'pgsql:host=localhost;dbname=analytics',
'username' => 'analyst',
'password' => 'xxx',
],
然后代码里用 Yii::$app->db2 调用。注意：别在模型里写死 $this->getDb() 指向 db2，除非重写了该方法并确保所有关联查询都兼容。
执行原生 SQL 时别漏掉 createCommand() 和 execute() 的配对
新手常把 Yii::$app->db->createCommand("UPDATE ...") 当成执行语句，其实它只是构建对象，必须调用 ->execute() 或 ->queryAll() 才真正发请求：
// ❌ 不会执行
Yii::$app->db->createCommand("DELETE FROM user WHERE id=1");
// ✅ 正确写法
Yii::$app->db->createCommand("DELETE FROM user WHERE id=1")->execute();
// ✅ 查询也一样
$rows = Yii::$app->db->createCommand("SELECT * FROM user")->queryAll();
另外，涉及用户输入的 SQL 务必用参数绑定，而不是字符串拼接 —— createCommand() 支持 [':id' => $id] 形式，否则直接暴露 SQL 注入风险。
复杂点在于事务控制和连接复用：Yii 默认开启持久连接（'enablePersistent' => true），但长时间空闲可能被 MySQL 断开，需要配合 'attributes' => [/PDO::ATTR_ERRMODE => /PDO::ERRMODE_EXCEPTION] 和重试逻辑。这点很容易被忽略，尤其在队列任务或长脚本中。