Yii2如何修改迁移默认使用的数据库Schema（PostgreSQL RBAC迁移场景）

核心结论 #

完全不需要从零编写整套RBAC对应的数据库迁移文件。你既可以通过现有配置直接调整默认表生成的Schema路径，也可以基于官方自带的迁移文件做最小改动适配，不用重新实现4张RBAC表的完整结构逻辑。

两种可直接落地的实现方案 #

方案1：调整数据库连接的搜索路径（零迁移代码改动） #

PostgreSQL的表创建逻辑默认会将新表放到search_path指向的第一个有效Schema下，只要把目标Schema（比如示例里的appschema）放到搜索路径的优先级最前面，官方原命令生成的表就会自动落到目标Schema中，全程不需要修改迁移文件本身。
操作步骤：

• 在项目的数据库连接配置中，新增连接建立后的搜索路径设置，示例配置参考：

  'db' => [
      'class' => 'yii\db\Connection',
      'dsn' => 'pgsql:host=你的数据库地址;dbname=你的库名',
      'username' => '你的账号',
      'password' => '你的密码',
      // 连接开启后自动设置搜索路径，将目标Schema放在最前
      'on afterOpen' => function($event) {
          $event->sender->createCommand("SET search_path TO appschema,public")->execute();
      },
  ]
  

• 配置修改完成后，直接执行原迁移命令即可：
  yii migrate --migrationPath=@yii/rbac/migrations
• 注意：后续Web应用运行时的数据库连接，也要保持这个搜索路径配置，否则程序会因为找不到表路径而出现报错。

方案2：基于官方迁移文件做最小修改（不调整全局搜索路径） #

如果不想改动数据库连接的全局搜索路径，就可以复制官方迁移文件做定向修改，完全不用从头写表结构：

• 把@yii/rbac/migrations目录下的所有迁移文件，复制到项目自己的迁移目录（比如@app/migrations）
• 打开每个迁移文件的建表语句，给4张RBAC表名加上目标Schema前缀即可，比如把原来的
  $this->createTable('{{%auth_item}}', [...])
  改成
  $this->createTable('{{%appschema.auth_item}}', [...])
  涉及的4张表分别是auth_rule、auth_item、auth_item_child、auth_assignment
• 改完文件之后，执行项目常规迁移命令yii migrate，就会把所有表生成到appschema下
• 同步调整应用的DbManager组件配置，给每个表的路径加上Schema前缀，示例参考：

  'authManager' => [
      'class' => 'yii\rbac\DbManager',
      'ruleTable' => 'appschema.auth_rule',
      'itemTable' => 'appschema.auth_item',
      'itemChildTable' => 'appschema.auth_item_child',
      'assignmentTable' => 'appschema.auth_assignment',
  ]
  

常见注意事项 #

• 不要直接修改Yii框架核心目录下的RBAC迁移文件，否则后续框架升级时，改动会被覆盖，甚至出现迁移版本校验不通过的问题。
• 执行迁移前，要确保所用的数据库账号已经拥有appschema Schema的CREATE权限，否则会抛出权限不足的报错。
• 表生成完成后，可以通过PostgreSQL的系统表查询确认表实际归属的Schema，避免因为配置未生效导致表错误落到public Schema下。

内容的提问来源于stack exchange，提问作者Marco Cesana