Laravel中使用POPO模型时，如何创建模型间的关联关系？

这问题我之前在做Laravel仓储模式重构时也踩过坑，分享几个亲测有效的实现思路：

1. 手动实现关联属性与主动加载逻辑 #

最直接的方式是在POPO类中定义关联属性，并通过仓储层主动加载关联数据。

举个例子，假设我们有User和Post两个POPO：

// app/Domain/Models/User.php
namespace App\Domain\Models;

class User
{
    public function __construct(
        public int $id,
        public string $name,
        public ?string $email,
        public array $posts = [] // 关联的Post POPO集合
    ) {}

    // 可以提供方法来设置关联
    public function setPosts(array $posts): void
    {
        $this->posts = $posts;
    }
}

// app/Domain/Models/Post.php
namespace App\Domain\Models;

class Post
{
    public function __construct(
        public int $id,
        public string $title,
        public string $content,
        public int $userId
    ) {}
}

然后在仓储层，查询用户时同时获取关联的帖子并转换为POPO：

// app/Domain/Repositories/UserRepository.php
namespace App\Domain\Repositories;

use App\Domain\Models\User;
use App\Domain\Models\Post;
use App\Models\User as EloquentUser;

class UserRepository
{
    public function findByIdWithPosts(int $id): User
    {
        // 预先加载Eloquent关联，避免N+1问题
        $eloquentUser = EloquentUser::with('posts')->findOrFail($id);
        
        // 转换关联的帖子为Post POPO
        $posts = $eloquentUser->posts->map(function ($eloquentPost) {
            return new Post(
                $eloquentPost->id,
                $eloquentPost->title,
                $eloquentPost->content,
                $eloquentPost->user_id
            );
        })->toArray();
        
        // 返回带关联的User POPO
        return new User(
            $eloquentUser->id,
            $eloquentUser->name,
            $eloquentUser->email,
            $posts
        );
    }
}

2. 引入DTO转换层处理关联 #

如果关联较多，可以创建专门的转换类（Transformer）来统一处理Eloquent到POPO的转换，包括关联关系：

// app/Domain/Transformers/UserTransformer.php
namespace App\Domain\Transformers;

use App\Domain\Models\User;
use App\Models\User as EloquentUser;
use App\Domain\Transformers\PostTransformer;

class UserTransformer
{
    public function __construct(
        private PostTransformer $postTransformer
    ) {}

    public function transform(EloquentUser $eloquentUser): User
    {
        $posts = [];
        // 如果Eloquent模型加载了posts关联，就转换为Post POPO
        if ($eloquentUser->relationLoaded('posts')) {
            $posts = $eloquentUser->posts->map(fn($p) => $this->postTransformer->transform($p))->toArray();
        }

        return new User(
            $eloquentUser->id,
            $eloquentUser->name,
            $eloquentUser->email,
            $posts
        );
    }
}

// app/Domain/Transformers/PostTransformer.php
namespace App\Domain\Transformers;

use App\Domain\Models\Post;
use App\Models\Post as EloquentPost;

class PostTransformer
{
    public function transform(EloquentPost $eloquentPost): Post
    {
        return new Post(
            $eloquentPost->id,
            $eloquentPost->title,
            $eloquentPost->content,
            $eloquentPost->user_id
        );
    }
}

然后在仓储层只需调用转换类：

public function findByIdWithPosts(int $id): User
{
    $eloquentUser = EloquentUser::with('posts')->findOrFail($id);
    return $this->userTransformer->transform($eloquentUser);
}

3. 实现POPO的懒加载关联 #

如果想模仿Eloquent的懒加载特性，可以给POPO注入对应的仓储，在需要时才加载关联：

// app/Domain/Models/User.php
namespace App\Domain\Models;

use App\Domain\Repositories\PostRepository;

class User
{
    private ?array $posts = null;

    public function __construct(
        public int $id,
        public string $name,
        public ?string $email,
        private PostRepository $postRepository
    ) {}

    // 懒加载获取帖子
    public function getPosts(): array
    {
        if ($this->posts === null) {
            $this->posts = $this->postRepository->findByUserId($this->id);
        }
        return $this->posts;
    }
}

这种方式的好处是关联数据不会被提前加载，只有当调用getPosts()时才会从仓储获取，但要注意：

• 确保POPO的依赖注入由Laravel容器管理（比如在转换时注入仓储）
• 可以在仓储层做缓存优化，避免重复查询

关键注意事项 #

• 保持POPO的纯净性：不要让POPO依赖Eloquent模型，只依赖其他POPO或仓储接口，这样才能真正隔离领域层与框架层
• 避免N+1问题：在仓储层查询Eloquent时，一定要用with()预先加载关联，再统一转换为POPO
• 关联的更新逻辑：如果需要更新关联，比如给用户添加帖子，应该通过领域服务层调用对应的仓储方法，而不是在POPO里直接操作

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