如何在Yii2 Dektrium User中通过迁移添加多个用户？

我来给你详细讲讲怎么用Yii2的迁移功能批量添加用户，结合你提到的yii2-user扩展场景，步骤清晰又靠谱：

1. 生成迁移文件 #

首先在项目根目录的命令行里执行这条命令，生成一个专门用于批量添加用户的迁移文件：

yii migrate/create batch_insert_users

这条命令会在console/migrations目录下生成一个类似m240520_123456_batch_insert_users.php的文件，文件名里的时间戳是自动生成的，不用纠结它~

2. 编写批量添加用户的核心逻辑 #

打开刚才生成的迁移文件，把up()和down()方法替换成下面的代码，关键细节我都标注好了：

<?php

use yii\db\Migration;
use dektrium\user\models\User;
use dektrium\user\models\Profile;
use yii\rbac\Role;

class m240520_123456_batch_insert_users extends Migration
{
    public function up()
    {
        // 开启数据库事务，保证要么全部创建成功，要么全部回滚，避免出现半吊子的情况
        $transaction = Yii::$app->db->beginTransaction();
        
        try {
            // 这里定义你要批量添加的用户数组，想加多少就加多少
            $users = [
                [
                    'username' => 'admin1',
                    'email' => 'admin1@example.com',
                    'password' => 'Admin@123', // 注意要符合yii2-user的密码强度要求（比如大小写+数字/特殊字符）
                    'role' => 'admin', // 要提前在系统里创建好对应的角色哦
                    'full_name' => '管理员一号'
                ],
                [
                    'username' => 'editor1',
                    'email' => 'editor1@example.com',
                    'password' => 'Editor@123',
                    'role' => 'editor',
                    'full_name' => '内容编辑一号'
                ],
                // 继续添加更多用户...
            ];
            
            foreach ($users as $userData) {
                // 先检查这个邮箱的用户是否已经存在，避免重复创建
                if (User::find()->where(['email' => $userData['email']])->exists()) {
                    echo "用户 {$userData['email']} 已存在，跳过创建\n";
                    continue;
                }
                
                // 初始化用户模型
                $user = new User();
                $user->username = $userData['username'];
                $user->email = $userData['email'];
                $user->password = $userData['password'];
                $user->status = User::STATUS_ACTIVE; // 直接设置为激活状态，不用再验证邮箱
                
                // 保存用户，如果失败就抛出异常
                if (!$user->save()) {
                    throw new \Exception("创建用户 {$userData['email']} 失败：" . implode(', ', $user->getErrorSummary(true)));
                }
                
                // 可选：补充用户的个人资料（比如真实姓名）
                $profile = Profile::findOne(['user_id' => $user->id]);
                if ($profile) {
                    $profile->name = $userData['full_name'];
                    $profile->save(false); // 批量初始化阶段可以跳过验证，提高效率
                }
                
                // 可选：给用户分配对应的角色（如果用了RBAC权限系统）
                $authManager = Yii::$app->authManager;
                $role = $authManager->getRole($userData['role']);
                if ($role) {
                    $authManager->assign($role, $user->id);
                } else {
                    echo "角色 {$userData['role']} 不存在，跳过角色分配\n";
                }
                
                echo "成功创建用户 {$userData['email']}\n";
            }
            
            // 所有用户都创建成功后，提交事务
            $transaction->commit();
            echo "✅ 批量添加用户全部完成！\n";
        } catch (\Exception $e) {
            // 只要有一个用户创建失败，就回滚所有操作
            $transaction->rollBack();
            echo "❌ 批量添加用户失败：" . $e->getMessage() . "\n";
            return false;
        }
    }

    public function down()
    {
        // 可选：如果需要回滚迁移（删除批量添加的用户），可以在这里写逻辑
        $transaction = Yii::$app->db->beginTransaction();
        
        try {
            // 这里要和up方法里的用户邮箱对应上
            $userEmails = ['admin1@example.com', 'editor1@example.com'];
            
            foreach ($userEmails as $email) {
                $user = User::find()->where(['email' => $email])->one();
                if ($user) {
                    // 先删除用户的角色关联
                    Yii::$app->authManager->revokeAll($user->id);
                    // 再删除用户
                    $user->delete();
                    echo "已删除用户 {$email}\n";
                }
            }
            
            $transaction->commit();
            echo "✅ 回滚批量添加用户完成！\n";
        } catch (\Exception $e) {
            $transaction->rollBack();
            echo "❌ 回滚失败：" . $e->getMessage() . "\n";
            return false;
        }
    }
}

3. 关键细节说明 #

• 事务处理：用beginTransaction()包裹所有操作，确保批量操作的原子性，不会出现部分用户创建成功的情况。
• 重复检查：通过邮箱判断用户是否已存在，避免重复创建导致报错。
• 用户状态：直接设置为STATUS_ACTIVE，如果需要让用户自己激活，可以改成STATUS_INACTIVE，不过批量初始化一般直接激活更方便。
• 角色分配：要确保admin、editor这些角色已经在系统中存在（可以通过另一个迁移或者后台手动创建），如果不需要角色，可以删掉这部分代码。
• 密码要求：yii2-user默认有密码强度验证，所以密码要包含大小写字母+数字/特殊字符，不然会保存失败。

4. 执行迁移 #

最后在命令行里执行这条命令，运行迁移：

yii migrate

系统会提示你确认，输入yes回车就开始批量创建用户了，完成后会看到成功提示。

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