Eloquent ORM 是 Laravel 框架内置的一个 Active Record 实现，它为数据库操作提供了一种优雅、简洁的语法。通过 Eloquent，你可以使用 PHP 类的形式来表示数据库表，并通过这些类的实例来查询、插入、更新和删除数据库中的记录。下面详细介绍如何在 Laravel 项目中使用 Eloquent ORM。 ### 1. 定义模型 首先，你需要为你的数据库表定义 Eloquent 模型。每个 Eloquent 模型都映射到数据库中的一个表，默认情况下，模型名称的复数形式（首字母大写）会作为表名。例如，如果你有一个 `users` 表，你应该创建一个 `User` 模型。 在 Laravel 中，模型通常放在 `app/Models` 目录下。如果没有这个目录，你可能需要手动创建它，或者你也可以将模型放在 `app` 目录下。 ```php // 在 app/Models/User.php namespace App\Models; use Illuminate\Database\Eloquent\Model; class User extends Model { // } ``` ### 2. 数据库迁移 在使用 Eloquent 之前，确保你的数据库表已经通过迁移（Migration）创建好了。Laravel 的迁移允许你以一种数据库无关的方式定义和共享应用的数据库结构。 ```bash php artisan make:migration create_users_table --create=users ``` 然后在生成的迁移文件中定义你的表结构。 ### 3. 读取数据 你可以通过 Eloquent 模型很方便地查询数据库中的数据。 ```php use App\Models\User; // 获取所有用户 $users = User::all(); // 获取单个用户，通过主键 $user = User::find(1); // 使用查询构建器 $users = User::where('votes', '>', 100)->get(); // 链式操作 $users = User::where('votes', '>', 100)->orderBy('name', 'desc')->get(); ``` ### 4. 插入数据 使用 Eloquent 创建新记录也非常简单。 ```php $user = new User; $user->name = 'John Doe'; $user->email = 'john@example.com'; $user->save(); // 或者使用 create 方法，如果模型有 fillable 属性定义 User::create(['name' => 'Jane Doe', 'email' => 'jane@example.com']); ``` ### 5. 更新数据 更新现有记录也很直接。 ```php $user = User::find(1); $user->email = 'new.email@example.com'; $user->save(); // 或者使用 update 方法 User::where('id', 1)->update(['email' => 'another.email@example.com']); ``` ### 6. 删除数据 删除记录也很容易。 ```php $user = User::find(1); $user->delete(); // 或者 User::destroy(1); // 删除所有匹配的行 User::where('votes', '<', 100)->delete(); ``` ### 7. 关联关系 Eloquent 支持多种数据库关系，如一对一、一对多、多对多和远程一对多等。通过定义模型之间的关系，你可以轻松地查询相关的数据。 ```php // 在 User 模型中定义一对多关系 public function posts() { return $this->hasMany(Post::class); } // 查询用户及其所有帖子 $user = User::with('posts')->find(1); ``` ### 8. 自定义查询 Eloquent 允许你通过定义作用域（Scopes）来封装复杂的查询逻辑，从而使你的代码更加清晰和可重用。 ```php // 在 User 模型中定义一个作用域 public function scopePopular($query) { return $query->where('votes', '>', 100); } // 使用作用域 $users = User::popular()->get(); ``` 通过这些基本步骤，你可以开始在 Laravel 项目中使用 Eloquent ORM 来管理你的数据库操作了。Eloquent 提供了许多其他高级特性和选项，建议查阅 Laravel 官方文档以获取更全面的信息。