Laravel Eloquent ORM 进阶分享

引言

Laravel 的 Eloquent ORM（Object-Relational Mapping）提供了一种优雅、简洁的方式来与数据库进行交互。它不仅仅是一个简单的 ORM，还包含了丰富的功能，能够帮助开发者高效地管理数据库操作。本文将深入探讨 Eloquent ORM 的一些进阶用法，帮助你更好地利用这一强大的工具。

一、Eloquent 模型基础回顾

在深入探讨进阶用法之前，我们先回顾一下 Eloquent 模型的基础。

1.1 定义模型

在 Laravel 中，模型通常放在 app/Models 目录下。每个模型都对应数据库中的一张表。例如，我们有一个 User 模型：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 定义表名（如果不指定，默认为模型名的复数形式）
    protected $table = 'users';

    // 定义主键（如果不指定，默认为 'id'）
    public $primaryKey = 'id';

    // 定义可批量赋值的字段
    protected $fillable = ['name', 'email', 'password'];

    // 定义隐藏字段（不会出现在 JSON 序列化结果中）
    protected $hidden = ['password', 'remember_token'];
}

1.2 基本查询

Eloquent 提供了多种方法来执行数据库查询。例如：

// 获取所有用户
$users = User::all();

// 根据主键获取单个用户
$user = User::find(1);

// 根据条件获取用户
$user = User::where('name', 'John')->first();

二、Eloquent 进阶用法

2.1 全局作用域（Global Scopes）

全局作用域允许你定义适用于模型所有查询的约束条件。例如，我们可能希望所有查询都忽略被软删除的记录：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class User extends Model
{
    use SoftDeletes;

    // 定义全局作用域
    protected static function boot()
    {
        parent::boot();

        static::addGlobalScope('active', function (Builder $builder) {
            $builder->where('deleted_at', null);
        });
    }
}

2.2 本地作用域（Local Scopes）

本地作用域允许你在模型中定义可重用的查询约束。例如，我们定义一个查询活跃用户的本地作用域：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 定义本地作用域
    public function scopeActive($query)
    {
        return $query->where('status', 'active');
    }
}

// 使用本地作用域
$activeUsers = User::active()->get();

2.3 访问器和修改器（Accessors & Mutators）

访问器和修改器允许你在获取或设置模型属性时自动执行代码。例如，我们希望自动格式化用户的电子邮件为小写：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 定义访问器
    public function getEmailAttribute($value)
    {
        return strtolower($value);
    }

    // 定义修改器
    public function setEmailAttribute($value)
    {
        $this->attributes['email'] = strtolower($value);
    }
}

2.4 多态关联（Polymorphic Relations）

多态关联允许你在不同类型的模型之间建立关联。例如，我们有一个 Post 模型，它可以被 User 或 Admin 创建：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    public function creator()
    {
        return $this->morphTo();
    }
}

class User extends Model
{
    public function posts()
    {
        return $this->morphMany(Post::class, 'creator');
    }
}

class Admin extends Model
{
    public function posts()
    {
        return $this->morphMany(Post::class, 'creator');
    }
}

2.5 查询构造器与 Eloquent 的结合使用

Eloquent 模型提供了丰富的查询方法，但有时你可能需要结合使用查询构造器来实现更复杂的查询。例如：

$users = User::whereHas('posts', function ($query) {
    $query->where('created_at', '>', now()->subMonth());
})->with('posts')->get();

在这个例子中，我们使用了 whereHas 方法来查询拥有最近一个月内发布的文章的用户，并使用 with 方法来预加载这些文章。

三、总结

Eloquent ORM 是 Laravel 框架中非常强大且灵活的一部分。通过掌握全局作用域、本地作用域、访问器和修改器、多态关联以及查询构造器与 Eloquent 的结合使用等进阶用法，你可以更高效地管理数据库操作，写出更简洁、可维护的代码。希望本文对你有所帮助，祝你在 Laravel 开发中取得更大的进步！