yii2数据库连接必须注册为id为db的应用组件，否则报“unknown component id: db”；表前缀通过db配置的tableprefix属性设置，配合{{%table}}语法实现自动替换。
安装 Yii2 后，数据库连接和表前缀是两个独立但常一起配置的关键项。连接配置让框架能访问数据库，表前缀则统一管理多项目共用库时的命名隔离。两者都通过 db 组件完成，但作用层级不同：连接定义“能不能连”，前缀定义“连上后怎么认表”。
配置数据库连接
Yii2 要求数据库配置必须注册为应用组件，ID 为 db，否则调用 Yii::$app->db 会报 “Unknown Component ID: db”。推荐在 config/db.php 单独维护，再引入主配置文件：
- 新建
config/db.php，返回标准连接数组：
return [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=myapp;charset=utf8mb4',
'username' => 'root',
'password' => '',
'charset' => 'utf8mb4',
]; - 在
config/web.php（或config/main.php）的components数组中引入：
'db' => require __DIR__ . '/db.php', - 验证是否生效：在任意控制器里写
var_dump(Yii::$app->db);，应输出yii\db\Connection实例对象
设置表前缀
表前缀不是必需项，但对多人协作、多环境部署或迁移旧系统很有用。它只影响 ActiveRecord 和 Query Builder 对表名的解析，不改变实际数据库结构。
- 在
db配置数组中添加'tablePrefix' => 'tbl_'（注意是字符串，末尾带下划线）：
'db' => [
// ... 其他配置
'tablePrefix' => 'tbl_',
], - 模型中声明表名时使用语法
{{%user}}，百分号会被自动替换为前缀：
public static function tableName()
{
return '{{%user}}';
} - 原生 SQL 查询也支持该语法：
Yii::$app->db->createCommand("SELECT * FROM {{%log}}")->queryAll();
常见问题提醒
配置看似简单，但几个细节容易出错：
-
DSN 格式必须严格：驱动名 + 冒号 + 分号分隔参数，不能换行、不能有空格或注释，
charset=utf8mb4建议放在 DSN 末尾 -
host 别写 localhost（尤其 Docker 环境）：容器内 localhost 指向自身，应改用服务名如
mysql或宿主机 IP -
表前缀仅对 {{%xxx}} 生效：直接写
'user'或'tbl_user'不会触发替换，也不报错，但会绕过前缀逻辑 -
多个数据库需不同组件 ID：如日志库用
'logdb'，不能也叫db，且对应模型要重写getDb()方法
