Laravel Eloquent ORM？ORM怎样操作数据库？-Laravel-PHP中文网

Laravel Eloquent ORM通过模型实现数据库操作，支持CRUD、关系管理、查询作用域、访问器/修改器、多态关联等高级功能，提升代码可读性与安全性，结合预加载、分块处理、索引优化等策略可有效避免N+1查询和内存溢出，适用于大多数业务场景并支持复杂查询扩展。

laravel eloquent orm？orm怎样操作数据库？

Laravel Eloquent ORM 是 Laravel 框架中一个强大的对象关系映射（ORM）工具，它以一种优雅的方式让开发者通过操作对象来与数据库进行交互，而不是直接编写 SQL 语句。简单来说，ORM 就像一个翻译官，将我们面向对象的代码“翻译”成数据库能理解的 SQL 语句，并将数据库返回的结果“翻译”成我们代码能理解的对象。这样一来，操作数据库就变得像操作普通 PHP 对象一样直观。

解决方案

Laravel Eloquent ORM 的核心在于其“模型”（Model）的概念。每个模型通常对应数据库中的一张表，通过模型实例，我们可以执行数据的创建、读取、更新和删除（CRUD）等操作。

1. 定义模型： 假设我们有一个

users

登录后复制

表，我们首先需要创建一个

User

登录后复制

模型。

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

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    use HasFactory;

    // 默认情况下，Eloquent 会将模型名复数化作为表名（User -> users）
    // 如果表名不符合这个约定，可以手动指定：
    // protected $table = 'my_users_table';

    // 默认情况下，Eloquent 假定主键是 'id' 且是自增的
    // 如果不是，可以指定：
    // protected $primaryKey = 'user_id';
    // public $incrementing = false;

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

    // 在数组或 JSON 序列化时隐藏的字段
    protected $hidden = [
        'password',
        'remember_token',
    ];

    // 属性类型转换
    protected $casts = [
        'email_verified_at' => 'datetime',
        'password' => 'hashed',
    ];
}

登录后复制

2. 创建数据： 通过模型实例的

save()

登录后复制

方法或

create()

登录后复制

静态方法。

// 方法一：实例化后赋值再保存
$user = new User;
$user->name = 'Alice';
$user->email = 'alice@example.com';
$user->password = bcrypt('secret'); // 密码通常需要哈希
$user->save(); // 此时数据会被插入到数据库

// 方法二：使用 create() 静态方法（需要模型设置 $fillable 属性）
$user = User::create([
    'name' => 'Bob',
    'email' => 'bob@example.com',
    'password' => bcrypt('another_secret'),
]);

登录后复制

3. 读取数据： 使用

all()

登录后复制

find()

登录后复制

where()

登录后复制

等方法。

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

// 根据主键 ID 查找单个用户
$user = User::find(1); // 如果找不到，返回 null

// 根据其他字段查找单个用户
$user = User::where('email', 'alice@example.com')->first(); // 返回第一个匹配的用户，找不到返回 null
$user = User::firstWhere('email', 'alice@example.com'); // 简写形式

// 查找所有符合条件的用户
$activeUsers = User::where('status', 'active')
                   ->where('created_at', '>', '2023-01-01')
                   ->orderBy('name', 'asc')
                   ->get(); // 返回一个集合（Collection）

// 获取特定字段
$names = User::select('name', 'email')->get();

// 分页查询
$paginatedUsers = User::paginate(15);

登录后复制

4. 更新数据： 获取模型实例后修改属性，再调用

save()

登录后复制

方法。也可以使用

update()

登录后复制

静态方法。

// 方法一：先查找再更新
$user = User::find(1);
if ($user) {
    $user->name = 'Alicia';
    $user->save();
}

// 方法二：使用 update() 静态方法（返回受影响的行数）
$affectedRows = User::where('email', 'bob@example.com')->update([
    'name' => 'Robert',
    'updated_at' => now(), // 手动更新时间戳，Eloquent 会自动处理 created_at 和 updated_at
]);

登录后复制

5. 删除数据： 获取模型实例后调用

delete()

登录后复制

方法，或使用

destroy()

登录后复制

where()

登录后复制

静态方法。

// 方法一：先查找再删除
$user = User::find(1);
if ($user) {
    $user->delete(); // 软删除或硬删除取决于模型是否使用了 SoftDeletes trait
}

// 方法二：根据主键 ID 删除
User::destroy(2); // 删除 ID 为 2 的用户
User::destroy([3, 4, 5]); // 删除 ID 为 3, 4, 5 的用户

// 方法三：根据条件删除
User::where('status', 'inactive')->delete();

登录后复制

6. 关系操作： Eloquent 强大的地方在于它能轻松处理模型间的关系。例如，一个用户可以有多个帖子。

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

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $fillable = ['title', 'content', 'user_id'];

    public function user()
    {
        return $this->belongsTo(User::class); // 一个 Post 属于一个 User
    }
}

// app/Models/User.php (添加关系)
class User extends Model
{
    // ... 其他属性

    public function posts()
    {
        return $this->hasMany(Post::class); // 一个 User 有多个 Post
    }
}

// 使用关系
$user = User::find(1);
foreach ($user->posts as $post) {
    echo $post->title;
}

$post = Post::find(1);
echo $post->user->name; // 获取帖子的作者名

登录后复制

为什么在Laravel项目中选择Eloquent ORM而非原生SQL？

我个人觉得，在大多数 Laravel 项目中，选择 Eloquent ORM 而非直接编写原生 SQL 语句，简直是生产力上的飞跃。这并不是说原生 SQL 一无是处，而是 Eloquent 提供了太多便利，让我们能专注于业务逻辑，而不是繁琐的数据库交互细节。

首先，代码可读性和维护性大幅提升。想一下，

User::where('status', 'active')->get()

登录后复制

比

SELECT * FROM users WHERE status = 'active'

登录后复制

要更符合面向对象的思维，也更容易理解。当项目规模变大，SQL 语句变得复杂时，这种差异会更明显。调试和修改一个 Eloquent 查询，通常比修改一段嵌入在 PHP 代码中的原生 SQL 要简单得多。

其次，安全性是 Eloquent 的一个重要优势。它内置了对 SQL 注入的防护。你不需要手动去对输入进行转义，Eloquent 会自动处理参数绑定，这大大降低了因开发者疏忽而引入安全漏洞的风险。而如果使用原生 SQL，每一次查询你都得小心翼翼地处理输入，这很考验开发者的细心程度。

再者，面向对象的操作让数据处理更自然。我们操作的是

User

登录后复制

对象，而不是一行行的数据。你可以直接访问

user->name

登录后复制

，而不是

row['name']

登录后复制

。这种抽象让业务逻辑的实现更加流畅，也更容易与 PHP 的其他面向对象特性结合。

当然，Eloquent 也不是万能的。在某些极端复杂的查询、需要极致性能优化，或者利用特定数据库的高级功能时，你可能仍然需要退回到 Laravel 的查询构建器（Query Builder）甚至

DB::raw()

登录后复制

来编写原生 SQL。比如，我曾经遇到一个报表需求，需要进行多表联合、子查询、复杂的聚合函数，这时候 Eloquent 的表达能力就显得有点力不从心，或者说，用 Eloquent 写出来的查询会变得非常冗长且不易理解，反而不如直接写 SQL 清晰。我的经验是，对于80%甚至90%的常见数据库操作，Eloquent 都能优雅地解决，剩下的那部分，知道何时“跳出”Eloquent，使用更底层的工具，也是一个成熟开发者必备的技能。

Eloquent ORM的常见性能陷阱与优化策略

尽管 Eloquent 极大地简化了数据库操作，但如果不注意使用方式，也可能引入性能问题。我见过不少项目因为不恰当的 Eloquent 用法而导致 N+1 查询、内存溢出等问题。

1. N+1 查询问题： 这是最常见的性能陷阱。当你在循环中访问关联模型时，就会发生 N+1 查询。例如：

$users = User::all();
foreach ($users as $user) {
    echo $user->posts->count(); // 每次循环都会去数据库查询该用户的帖子
}
// 如果有 100 个用户，这里会执行 1 (获取用户) + 100 (获取每个用户的帖子) = 101 次查询

登录后复制

优化策略： 使用预加载（Eager Loading），通过

with()

登录后复制

方法一次性加载所有关联数据。

库宝AI

库宝AI是一款功能多样的智能伙伴助手，涵盖AI写作辅助、智能设计、图像生成、智能对话等多个方面。

109

查看详情

$users = User::with('posts')->get(); // 只执行 2 次查询：一次获取用户，一次获取所有用户的帖子
foreach ($users as $user) {
    echo $user->posts->count(); // 关联数据已经加载，不再产生额外查询
}

登录后复制

你也可以预加载多个关系，甚至嵌套关系：

User::with(['posts', 'comments.user'])->get()

登录后复制

。

2. 大数据集处理： 当你需要处理成千上万条记录时，

all()

登录后复制

或

get()

登录后复制

可能会一次性加载所有数据到内存，导致内存溢出。

优化策略：

分块处理（Chunking）： 使用
```
chunk()
```
登录后复制
或
```
chunkById()
```
登录后复制
方法分批处理数据，每次只加载一部分到内存。

User::chunk(100, function ($users) {
    foreach ($users as $user) {
        // 处理每批用户
    }
});

登录后复制

游标（Cursor）： 对于非常大的数据集，
```
cursor()
```
登录后复制
方法可以只从数据库中检索一条记录，然后将其传递给回调函数，大大减少内存占用。

foreach (User::cursor() as $user) {
    // 处理单个用户
}

登录后复制

分页（Pagination）： 如果是展示给用户的数据，使用
```
paginate()
```
登录后复制
方法进行分页，只加载当前页的数据。

3. 不必要的字段检索： 默认情况下，Eloquent 会选择表中的所有字段 (

SELECT *

登录后复制

)。但很多时候，我们只需要少数几个字段。

优化策略： 使用

select()

登录后复制

方法明确指定需要检索的字段。

$users = User::select('id', 'name', 'email')->get();
// 这样可以减少从数据库传输的数据量，提高查询效率。

登录后复制

4. 索引优化： 这虽然不是 Eloquent 本身的问题，但与数据库性能息息相关。确保你的数据库表在经常用于

where

登录后复制

条件、

order by

登录后复制

或

join

登录后复制

的字段上建立了合适的索引。

优化策略： 通过 Laravel 的迁移（Migrations）工具创建索引。

Schema::table('users', function (Blueprint $table) {
    $table->index('email');
    $table->index(['status', 'created_at']); // 复合索引
});

登录后复制

5. 缓存机制： 对于不经常变动但频繁查询的数据，使用缓存可以显著提升性能。

优化策略： Laravel 提供了强大的缓存系统。你可以手动缓存 Eloquent 查询结果，或者使用像

remember()

登录后复制

这样的辅助函数。

$activeUsers = Cache::remember('active_users', 60, function () {
    return User::where('status', 'active')->get();
});

登录后复制

在我看来，性能优化是一个持续的过程，没有一劳永逸的方案。我们应该在开发初期就考虑这些问题，并通过 Laravel Debugbar 或 Telescope 等工具监控查询，及时发现并解决潜在的性能瓶颈。过早优化是万恶之源，但对于已知的性能陷阱，提前规避总是明智的。

如何处理Eloquent ORM中的复杂查询与高级特性？

Eloquent ORM 远不止基本的 CRUD 和关系操作，它提供了一系列高级特性来处理更复杂的查询逻辑和数据转换。这就像是一个工具箱，里面有各种专业的工具，用好了能事半功倍。

1. 查询作用域（Query Scopes）： 当你在多个地方重复使用相同的查询条件时，查询作用域就显得非常有用。它允许你将常用的查询逻辑封装成可复用的方法。

局部作用域（Local Scopes）： 定义在模型内部。

// app/Models/User.php
class User extends Model
{
    public function scopeActive($query)
    {
        return $query->where('status', 'active');
    }

    public function scopePopular($query)
    {
        return $query->where('views', '>', 1000);
    }
}

// 使用方式
$activeUsers = User::active()->get();
$popularActiveUsers = User::active()->popular()->get();

登录后复制

全局作用域（Global Scopes）： 自动应用于模型的所有查询，除非你明确禁用。这对于软删除等功能非常有用。

// 定义一个全局作用域
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

class ActiveUserScope implements \Illuminate\Database\Eloquent\Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('status', 'active');
    }
}

// 在模型中应用全局作用域
class User extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new ActiveUserScope);
    }
}
// 此时，User::all() 默认只会返回 status 为 'active' 的用户。
// 要禁用全局作用域，可以使用 User::withoutGlobalScope(ActiveUserScope::class)->get();

登录后复制

2. 访问器（Accessors）与修改器（Mutators）： 它们允许你在从数据库获取模型属性或将模型属性保存到数据库时，自动进行数据转换。

访问器（获取时转换）：

// app/Models/User.php
class User extends Model
{
    // 获取用户全名
    public function getFullNameAttribute()
    {
        return $this->first_name . ' ' . $this->last_name;
    }
}
// 使用方式：$user->full_name

登录后复制

修改器（设置时转换）：

// app/Models/User.php
class User extends Model
{
    // 将用户输入的名称首字母大写
    public function setNameAttribute($value)
    {
        $this->attributes['name'] = ucwords($value);
    }
}
// 使用方式：$user->name = 'john doe'; 数据库中会保存 'John Doe'

登录后复制

3. 多态关联（Polymorphic Relations）： 当一个模型可以属于多个其他模型时，多态关联就派上用场了。例如，一个

Comment

登录后复制

模型可能属于

Post

登录后复制

，也可能属于

Video

登录后复制

。

// app/Models/Comment.php
class Comment extends Model
{
    public function commentable()
    {
        return $this->morphTo();
    }
}

// app/Models/Post.php
class Post extends Model
{
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

// app/Models/Video.php
class Video extends Model
{
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

// 使用方式：
$post = Post::find(1);
$post->comments->each(fn($comment) => echo $comment->content);

$comment = Comment::find(1);
echo $comment->commentable->title; // 如果 commentable 是 Post

登录后复制

4. 自定义类型转换（Custom Casts）： Eloquent 允许你自定义属性的类型转换逻辑，例如将一个 JSON 字符串自动转换为 PHP 对象，或者将一个枚举值转换为可读的字符串。

// app/Models/User.php
class User extends Model
{
    protected $casts = [
        'options' => 'array', // 将 JSON 字符串自动转换为 PHP 数组
        'is_admin' => 'boolean',
    ];
}
// 此时 $user->options 会是一个数组，而不是 JSON 字符串。

登录后复制

5. 模型事件（Model Events）： 在模型的生命周期中，Eloquent 会触发一系列事件（如

creating

登录后复制

created

登录后复制

updating

登录后复制

updated

登录后复制

deleting

登录后复制

deleted

登录后复制

等）。你可以在这些事件中执行额外的逻辑，比如发送通知、更新缓存等。

// app/Providers/AppServiceProvider.php 或独立的 Service Provider
use App\Models\User;

public function boot()
{
    User::creating(function (User $user) {
        // 在用户创建前执行一些验证或默认值设置
        if (empty($user->status)) {
            $user->status = 'pending';
        }
    });

    User::deleted(function (User $user) {
        // 用户删除后，清理相关资源
        Log::info("User {$user->id} deleted.");
    });
}

登录后复制

这些高级特性无疑增加了 Eloquent 的灵活性和强大程度。在我实际开发中，我发现查询作用域和访问器/修改器是使用频率最高的，它们能让代码更加整洁和模块化。多态关联则在处理复杂业务关系时，避免了大量的重复代码。当然，这些工具的使用也需要一定的经验和对业务的深入理解，不恰当的使用反而可能导致过度设计或难以调试的问题。关键在于找到平衡点，用最合适的工具解决当前的问题。

以上就是Laravel Eloquent ORM？ORM怎样操作数据库？的详细内容，更多请关注php中文网其它相关文章！