在Yii里配置数据库，标准动作是把连接参数整理成一个数组，放到config/db.php，然后在应用配置里注册为db组件，只要掌握这条路径，后续增减数据库、改连接方式都不会乱。
yii数据库配置方法：从db.php到组件化连接
很多人第一次打开Yii项目，盯着config目录不知道从哪儿下手，其实Yii的数据库配置思路很直白：连接信息独立成文件，应用组件统一加载，高级模板（yii-advanced-app）和基础模板（yii-basic-app）各有分工,但核心逻辑一致。
高级模板的数据库配置通常放在common/config/main-local.php里，基础模板直接编辑config/db.php，无论哪种,最终都会变成应用的一个组件。
yii2数据库连接配置：DSN、账号与密码的细节
Yii2的数据库连接使用PDO，DSN的写法直接决定能不能连上，以MySQL为例,最典型的配置如下：
return [
'class' => 'yiidbConnection',
'dsn' => 'mysql:host=localhost;dbname=your_database',
'username' => 'root',
'password' => 'your_password',
'charset' => 'utf8mb4',
];
这里有几处容易踩坑：
dbname要和实际数据库名完全一致,大小写敏感。host写localhost时走socket，写0.0.1时走TCP,本地调试常常因为这两者混用而报错。charset建议用utf8mb4，兼容emoji和生僻字,这是当前的主流选择。
如果你用的是PostgreSQL，DSN就换成pgsql:host=localhost;port=5432;dbname=your_database,SQLite则直接指向文件路径。
把db配置挂到应用组件的正确姿势
单文件配置完成后，需要在主配置里注册组件，基础模板的config/web.php中写入：
'db' => require __DIR__ . '/db.php',
高级模板则是在common/config/main-local.php的components数组里注册，注册完成后，才能通过Yii::$app->db执行查询，这一步不做好,后续所有模型和查询都会找不到数据库连接。
yii配置多个数据库的思路与踩坑记录
项目做大后，读写分离、分库分表、独立日志库都是常见场景，Yii支持在同一应用里声明多个数据库组件,关键就是给组件起不同的名字。
直接定义db2组件
在components里加一个db2：
'components' => [
'db' => require __DIR__ . '/db.php',
'db2' => [
'class' => 'yiidbConnection',
'dsn' => 'mysql:host=readonly-host;dbname=analytics',
'username' => 'report',
'password' => 'report_pwd',
'charset' => 'utf8mb4',
],
],
使用时直接调用Yii::$app->db2->createCommand()->queryAll()，多数情况下，这种方式用来解决主从分离：db负责写入，db2负责报表查询。
用ActiveRecord指定连接
如果你用AR操作，可以在模型类里重写getDb()方法：
public static function getDb()
{
return Yii::$app->db2;
}
这样这个模型的所有查询都会走db2,业务代码保持干净。
下表对比两种方案的使用场景：
| 方案 | 适合场景 | 复杂度 |
|---|---|---|
| 定义db2组件 | 命令行脚本、临时跨库查询 | 低 |
| 重写getDb() | 固定模型映射到特定库 | 中 |
yii数据库配置价格怎么算？
聊到yii数据库配置价格，得看你是自己干还是外包，一个简单的单库配置，具备Yii基础的人半小时能搞定，基本无成本，但如果涉及读写分离、多库同步、配置调优，外包报价通常按项目复杂度来，常见范围在几百到几千元不等，没有统一行情，业内专家指出，与其纠结单价，不如把需求边界说清楚，让对方列出DSN配置、缓存策略和灾备方案,价格自然透明。
yii数据库连接失败怎么解决？先查这三个地方
遇到“Database Exception – yiidbException”别慌，九成问题出在配置细节上，按下面顺序排查,能省下大量时间。
检查DSN字符串是否手滑
DSN里最容易错的是dbname拼写、host和port之间用错分隔符,正确格式是：
mysql:host=localhost;port=3306;dbname=test注意分号是英文半角，空格不要出现在赋值符号附近，如果你用的是特殊端口，比如云数据库的3306映射到3310,一定要在DSN里写清楚。
检查PHP扩展与数据库服务状态
连接建立不了，很可能是PHP环境缺少对应扩展。PHP连接MySQL需要pdo_mysql扩展，连接PostgreSQL需要pdo_pgsql扩展，运行php -m看扩展列表，确认后再看数据库服务本身是否启动、账号是否有远程访问权限，本地启用了防火墙,也要放行对应端口。
清除配置缓存和本地调试
Yii在某些情况下会缓存配置，比如使用yiicachingFileCache时，此时改了配置没生效,就得清缓存：
php yii cache/flush-all
同时打开应用开启YII_DEBUG,错误信息里会显示到底哪一行配置引发异常。
Yii数据库配置优化与安全备忘
配置能跑通只是起点,生产环境还得考虑性能和敏感信息保护。
开启表结构缓存
Yii的AR依赖表结构信息，每次查询都可能访问数据库元数据，行业共识认为,生产环境应开启schema缓存：
'components' => [
'db' => [
'class' => 'yiidbConnection',
'enableSchemaCache' => true,
'schemaCacheDuration' => 3600,
'schemaCache' => 'cache',
],
],
这样表结构只加载一次，能降低不少数据库压力，代价是表结构变更后要清缓存,否则新字段无法识别。
避免在配置文件里写明文密码
把明文密码放在仓库里，一旦代码泄露就全完,较好的做法是使用环境变量：
'password' => getenv('DB_PASSWORD'),
配合.env文件管理，可以在不同服务器间切换配置而不改代码，统计显示，相当一部分Yii项目被脱库是因为配置文件提交到了公开仓库,这个习惯必须改。
最后说一句
Yii数据库配置没有玄学，就是组件注册 + DSN正确 + 缓存策略的组合，先把单库跑通，再按业务需求扩展多库，遇到问题按流程排查,大部分坑都能避开。
yii数据库配置常见问题Q&A
问：改完db.php后没生效，重启了PHP-FPM也没用？
配置没生效时先检查是否开了APC或Opcache缓存，它们会缓存解析过的PHP文件，运行php yii cache/flush-all，并重启PHP-FPM，另外确认你改的是正确路径高级模板里是common/config/main-local.php，不是console/config/main.php。
问：yii配置多个数据库后，可以进行跨库关联查询吗？
两个数据库如果在同一台MySQL实例上，可以在DSN里统一指向目标库，直接写表名，如果不在同一实例，Yii原生AR不支持跨库join，需要手动创建Command执行一条关联语句，把结果用QueryDataProvider包装，或者借助联合查询插件，最现实的做法是让一个连接用户拥有多个库的访问权限,然后通过带库名的SQL操作。
问：连接池和持久连接选哪个？
Yii2本身没有内置连接池，MySQL的PDO支持ATTR_PERSISTENT开启持久连接，但在PHP-FPM下容易造成连接数积压，多数情况下不推荐生产环境常开，连接池需要借助Swoole或单独的代理组件实现，维护成本较高，适合长驻内存的进程模型，普通Web项目保持默认短连接,配合数据库端的连接复用即可。