PHP项目Laravel hasManyThrough关联用法

wen PHP项目 2026-08-12 5

本文目录导读：

基本概念
数据库表结构
使用示例
高级用法
完整示例：控制器中使用
路由定义
注意事项

在 Laravel 中，hasManyThrough 关联用于通过中间模型访问远端模型的关联数据,这在处理多层级关系时非常有用。

基本概念

假设我们有这样的关系：

国家 (Country) → 有多个 用户 (User)
用户 (User) → 有多个 帖子 (Post)

通过 hasManyThrough，我们可以直接获取一个国家的所有帖子,而无需通过用户。

数据库表结构

countries
    id
    name
users
    id
    country_id
    name
posts
    id
    user_id```
## 模型定义
### 1. Country 模型
```php
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasManyThrough;
class Country extends Model
{
    protected $fillable = ['name'];
    /**
     * 获取该国家的所有帖子
     */
    public function posts(): HasManyThrough
    {
        return $this->hasManyThrough(
            Post::class,   // 最终要访问的模型
            User::class,   // 中间模型
            'country_id',  // 中间模型的外键 (users.country_id)
            'user_id',     // 最终模型的外键 (posts.user_id)
            'id',          // 当前模型的主键 (countries.id)
            'id'           // 中间模型的本地键 (users.id)
        );
    }
}

User 模型

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class User extends Model
{
    protected $fillable = ['name', 'country_id'];
    public function country(): BelongsTo
    {
        return $this->belongsTo(Country::class);
    }
    public function posts(): HasMany
    {
        return $this->hasMany(Post::class);
    }
}

Post 模型

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class Post extends Model
{
    protected $fillable = ['title', 'content', 'user_id'];
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }
}

使用示例

基本查询

// 获取某个国家的所有帖子
$country = Country::find(1);
$posts = $country->posts;
// 带条件筛选
$activePosts = $country->posts()
    ->where('posts.status', 'active')
    ->get();
// 根据时间排序
$recentPosts = $country->posts()
    ->latest()
    ->take(10)
    ->get();

查询优化

// 预加载关联，避免 N+1 查询
$countries = Country::with('posts')->get();
foreach ($countries as $country) {
    foreach ($country->posts as $post) {
        echo $post->title;
    }
}
// 预加载嵌套关联
$countries = Country::with('posts.user')->get();

统计查询

// 获取每个国家的帖子数量
$countries = Country::withCount('posts')->get();
foreach ($countries as $country) {
    echo "{$country->name}: {$country->posts_count} 篇帖子";
}
// 添加条件统计
$countries = Country::withCount(['posts' => function($query) {
    $query->where('status', 'published');
}])->get();

复杂查询

// 获取所有有帖子的国家
$countriesWithPosts = Country::has('posts')->get();
// 获取帖子数量大于5的国家
$popularCountries = Country::has('posts', '>', 5)->get();
// 使用 whereHas 进行条件过滤
$countries = Country::whereHas('posts', function($query) {
    $query->where('title', 'like', '%Laravel%');
})->get();

自定义关联名称和限制

class Country extends Model
{
    /**
     * 获取该国家的所有已发布帖子
     */
    public function publishedPosts(): HasManyThrough
    {
        return $this->hasManyThrough(
            Post::class,
            User::class,
            'country_id',
            'user_id'
        )->where('status', 'published');
    }
}
// 使用
$publishedPosts = $country->publishedPosts;

高级用法

使用关联进行更新和删除

// 使用关联直接创建帖子（需要通过用户）
$country = Country::find(1);
$user = $country->users()->first();
$post = $user->posts()->create([ => '新的帖子',
    'content' => '内容...'
]);
// 批量更新
$country->posts()->update(['status' => 'draft']);

关联聚合函数

// 聚合查询
// 获取每个国家的平均帖子数
$stats = Country::with('posts')
    ->get()
    ->map(function($country) {
        return [
            'country' => $country->name,
            'avg_posts' => $country->posts->count()
        ];
    });
// 使用 DB 查询进行更复杂的统计
$stats = DB::table('countries')
    ->selectRaw('countries.name, COUNT(posts.id) as post_count')
    ->leftJoin('users', 'users.country_id', '=', 'countries.id')
    ->leftJoin('posts', 'posts.user_id', '=', 'users.id')
    ->groupBy('countries.id')
    ->get();

分页

// 分页获取某个国家的帖子
$posts = $country->posts()
    ->paginate(15);
// 在视图中的使用方式
// {{ $posts->links() }}

完整示例：控制器中使用

<?php
namespace App\Http\Controllers;
use App\Models\Country;
use Illuminate\Http\Request;
class CountryPostController extends Controller
{
    public function index(Country $country)
    {
        // 获取该国家的所有帖子
        $posts = $country->posts()
            ->with('user')  // 预加载用户
            ->latest()
            ->paginate(10);
        return view('countries.posts', compact('country', 'posts'));
    }
    public function popularPost(Country $country)
    {
        // 获取最受欢迎的帖子
        $popularPost = $country->posts()
            ->orderBy('likes_count', 'desc')
            ->first();
        return response()->json($popularPost);
    }
    public function stats(Country $country)
    {
        // 获取统计信息
        $stats = [
            'total_posts' => $country->posts()->count(),
            'active_users' => $country->users()->count(),
            'avg_posts_per_user' => $country->posts()->count() / max($country->users()->count(), 1)
        ];
        return response()->json($stats);
    }
}

路由定义

// routes/web.php
Route::get('/countries/{country}/posts', [CountryPostController::class, 'index']);
Route::get('/countries/{country}/popular-post', [CountryPostController::class, 'popularPost']);
Route::get('/countries/{country}/stats', [CountryPostController::class, 'stats']);

注意事项

性能考虑：当数据量较大时，使用 with() 预加载避免 N+1 问题
表结构命名：确保外键命名符合 Laravel 约定，或者明确指定
关联方向：hasManyThrough 是单向的，从父模型到远端模型
查询条件：添加条件时注意使用正确的别名和表名

这个关联模式特别适合处理多层级关系，让代码更简洁、可读性更强。