从Yii2迁移Laravel：Repository模式处理多关联模型创建问题

阿华AIGC实验室

2026-5-20

处理Laravel中Repository模式下的复杂用户创建逻辑

我之前刚好处理过从Yii2迁移到Laravel并引入Repository模式的项目，你的这个需求（创建User时同步生成Group、Permission等关联记录）其实正是Repository模式能解决控制器/模型臃肿问题的典型场景——把这些跨表的业务逻辑从零散的地方抽离出来，集中管理。

1. 别让Repository只做CRUD，封装完整业务操作

Repository的核心职责是封装与实体相关的所有业务行为，而不只是简单的增删改查。你可以先定义一个接口来规范行为，再用Eloquent实现具体逻辑，这样既保证了代码的可测试性，也方便后续替换实现：

// 定义用户仓库接口
interface UserRepositoryInterface
{
    /**
     * 创建用户并同步生成所有关联记录
     * @param array $userData 用户基础数据
     * @return User
     */
    public function createWithAssociations(array $userData): User;
}

// Eloquent实现类
class EloquentUserRepository implements UserRepositoryInterface
{
    public function createWithAssociations(array $userData): User
    {
        // 用数据库事务保证所有操作原子性，避免部分创建成功的情况
        return DB::transaction(function () use ($userData) {
            // 1. 创建用户主记录
            $user = User::create($userData);
            
            // 2. 将用户加入默认用户组
            $defaultGroup = Group::where('name', 'general_users')->firstOrFail();
            $user->groups()->attach($defaultGroup->id);
            
            // 3. 根据用户角色分配对应权限
            $permissionIds = match($userData['role']) {
                'admin' => Permission::whereIn('name', ['manage_users', 'view_dashboard'])->pluck('id'),
                'editor' => Permission::where('name', 'edit_content')->pluck('id'),
                'viewer' => Permission::where('name', 'view_content')->pluck('id'),
                default => []
            };
            $user->permissions()->attach($permissionIds);
            
            // 4. 创建其他关联记录（比如用户默认设置、个人资料等）
            $user->profile()->create(['bio' => '', 'avatar_url' => '/default-avatar.png']);
            $user->notificationSettings()->create(['email_enabled' => true]);
            
            return $user;
        });
    }
}

2. 控制器只做请求处理，彻底解耦

现在控制器里的代码会非常简洁，只需要接收请求参数、调用Repository的方法、返回响应，完全不用关心内部的关联创建逻辑：

class UserController extends Controller
{
    public function __construct(
        private UserRepositoryInterface $userRepository
    ) {}

    public function store(UserStoreRequest $request)
    {
        $validatedData = $request->validated();
        $user = $this->userRepository->createWithAssociations($validatedData);
        
        return redirect()->route('users.show', $user)->with('success', '用户创建成功');
    }
}

3. 拆分复用逻辑，保持Repository整洁

如果有些关联逻辑（比如加入默认组）需要在多个地方复用，可以把它们抽成Repository里的私有方法，或者单独的Trait，避免代码重复：

// 在EloquentUserRepository里添加私有方法
private function attachDefaultGroup(User $user): void
{
    $defaultGroup = Group::where('name', 'general_users')->firstOrFail();
    $user->groups()->attach($defaultGroup->id);
}

// 然后在createWithAssociations里调用
$this->attachDefaultGroup($user);