首页 > 文章 > php教程

LaravelEloquentORM入门指南

时间：2025-10-28 11:20:55 105浏览收藏

**Laravel Eloquent ORM 使用教程：提升数据库操作效率与性能** 深入学习 Laravel Eloquent ORM，掌握这款强大的数据库操作利器。Eloquent ORM 通过面向对象的方式，简化了数据库的增删改查，告别繁琐的 SQL 语句，让代码更简洁易懂。本文将详细介绍 Eloquent ORM 的基础与高级用法，包括关联关系（一对一、一对多、多对多、远层一对多）、作用域（全局作用域、局部作用域）、懒加载与预加载的区别，以及事件监听、软删除和集合方法等。此外，本文还将探讨如何通过预加载、索引、`select()` 方法、`chunk()` 方法和缓存等手段优化 Eloquent 查询性能，助您高效开发 Laravel 应用。掌握 Eloquent ORM，提升开发效率和应用性能。

Laravel Eloquent ORM通过面向对象方式操作数据库，支持关联关系、作用域、事件、软删除和集合方法，结合预加载与索引可提升查询性能。

LaravelEloquentORM怎么用_LaravelEloquentORM高级用法

Laravel Eloquent ORM，简单来说，就是Laravel框架用来操作数据库的利器。它让你可以用更面向对象的方式来增删改查数据库，不用直接写SQL语句，代码看起来更简洁易懂。高级用法则是在基础之上，更高效、更灵活地处理复杂的数据关系和查询需求。

Eloquent ORM 提供了简洁的 API，例如：

User::all() 获取所有用户
User::find(1) 获取 ID 为 1 的用户
$user->update(['name' => 'New Name']) 更新用户姓名

Eloquent ORM 关联关系如何玩转？

Eloquent 最大的优势之一就是它强大的关联关系处理能力。比如，一个用户可以有多篇文章，一篇文章可以有多个评论。这些关系在数据库中通过外键关联，Eloquent 让你能轻松地在模型之间建立这些关系。

一对一 (Has One / Belongs To)：例如，一个用户有一个个人资料。
```
// User 模型
public function profile()
{
    return $this->hasOne(Profile::class);
}

// Profile 模型
public function user()
{
    return $this->belongsTo(User::class);
}
```
这样，你就可以通过 $user->profile 访问用户的个人资料，通过 $profile->user 访问个人资料对应的用户。

一对多 (Has Many / Belongs To)：例如，一个用户有多篇文章。

// User 模型
public function posts()
{
    return $this->hasMany(Post::class);
}

// Post 模型
public function user()
{
    return $this->belongsTo(User::class);
}

可以通过 $user->posts 获取用户的所有文章。

多对多 (Belongs To Many)：例如，一个用户可以有多个角色，一个角色可以被多个用户拥有。

// User 模型
public function roles()
{
    return $this->belongsToMany(Role::class);
}

// Role 模型
public function users()
{
    return $this->belongsToMany(User::class);
}

可以通过 $user->roles 获取用户的所有角色。

远层一对多 (Has Many Through)：例如，一个国家有很多文章，但国家和文章之间没有直接的关联，而是通过用户关联。
```
// Country 模型
public function posts()
{
    return $this->hasManyThrough(Post::class, User::class);
}
```
可以通过 $country->posts 获取国家的所有文章。

Eloquent 作用域 (Scopes) 的妙用

作用域允许你定义常用的查询约束，并在模型中复用。这可以避免在多个地方重复编写相同的查询逻辑。

全局作用域 (Global Scopes)：全局作用域会自动应用到模型的所有查询中。例如，你可能希望只查询未被删除的数据。

// 定义全局作用域
class SoftDeletingScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->whereNull($model->getQualifiedDeletedAtColumn());
    }
}

// 在模型中使用全局作用域
protected static function boot()
{
    parent::boot();

    static::addGlobalScope(new SoftDeletingScope);
}

局部作用域 (Local Scopes)：局部作用域允许你定义命名的作用域，并在查询时手动调用。

// 定义局部作用域
public function scopePopular($query)
{
    return $query->where('votes', '>', 100);
}

// 使用局部作用域
$posts = Post::popular()->get();

懒加载 (Lazy Loading) 和预加载 (Eager Loading) 的区别？

懒加载是指在需要访问关联关系时才进行查询。这会导致 N+1 查询问题，即查询了 N 个模型，又额外查询了 N 次关联关系。

预加载是指在查询模型时，同时查询关联关系。这可以避免 N+1 查询问题，提高性能。

懒加载：

$users = User::all();

foreach ($users as $user) {
    echo $user->profile->phone; // 每次访问 profile 都会执行一次查询
}

预加载：

$users = User::with('profile')->get();

foreach ($users as $user) {
    echo $user->profile->phone; // profile 已经预加载，不会执行额外的查询
}

使用 with() 方法可以预加载关联关系。你还可以预加载多层关联关系，例如 User::with('posts.comments')->get()。

Eloquent 事件 (Events) 的应用场景？

Eloquent 事件允许你在模型创建、更新、删除等操作前后执行自定义代码。这可以用于实现诸如记录日志、发送通知、更新缓存等功能。

常用的事件：
- creating
- created
- updating
- updated
- saving
- saved
- deleting
- deleted
- restoring
- restored

使用事件：

// 在模型中定义事件监听器
protected static function boot()
{
    parent::boot();

    static::creating(function ($model) {
        $model->uuid = Str::uuid();
    });

    static::updated(function ($model) {
        // 发送通知
        Notification::send($model->user, new ModelUpdated($model));
    });
}

如何使用 Eloquent 实现软删除 (Soft Deletes)？

软删除是指在删除数据时，并不真正从数据库中删除，而是通过设置一个 deleted_at 字段来标记为已删除。这可以方便地恢复已删除的数据。

启用软删除：

use Illuminate\Database\Eloquent\SoftDeletes;

class User extends Authenticatable
{
    use SoftDeletes;

    protected $dates = ['deleted_at'];
}

查询已删除的数据：
- withTrashed()：包含已删除的数据
- onlyTrashed()：只包含已删除的数据
恢复已删除的数据：
```
$user->restore();
```

Eloquent 集合 (Collections) 的高级用法？

Eloquent 查询返回的结果是一个集合对象，它提供了许多方便的方法来处理数据。

常用的集合方法：
- map()：对集合中的每个元素执行回调函数
- filter()：过滤集合中的元素
- reject()：排除集合中的元素
- each()：遍历集合中的每个元素
- groupBy()：按指定字段分组
- sortBy()：按指定字段排序

示例：

$users = User::all();

// 获取所有用户的姓名
$names = $users->map(function ($user) {
    return $user->name;
});

// 获取所有活跃用户
$activeUsers = $users->filter(function ($user) {
    return $user->is_active;
});