LaravelEloquent使用教程详解

Laravel Eloquent 是 Laravel 框架中强大的 ORM（对象关系映射）系统，它简化了数据库操作，让开发者无需编写原生 SQL 语句，即可轻松实现数据的增删改查。本教程将深入讲解 Laravel Eloquent 的使用方法，包括如何定义模型与数据库表进行关联，自定义表名、主键和时间戳格式，以及如何使用 `all()`、`find()`、`where()` 等常用查询方法。此外，还将介绍批量插入时 `$fillable` 的设置，利用 `save()` 和 `update()` 进行数据更新，以及使用 `delete()` 和 `destroy()` 进行数据删除。更重要的是，我们将详细阐述 Eloquent 模型关联，包括一对一、一对多和多对多关系，以及访问器和修改器的使用，助你编写出更清晰、更易于维护的 Laravel 代码。

Laravel Eloquent通过模型操作数据库，无需写SQL即可实现增删改查。定义模型时默认关联复数表名，可自定义表名、主键和时间戳格式。常用查询包括all()、find()、where()等，支持批量插入需设置$fillable。更新可用save()或update()，删除用delete()或destroy()。支持一对一、一对多、多对多关联，通过hasOne、hasMany、belongsToMany定义。还可使用访问器格式化读取值，修改器处理写入值，使代码更清晰易维护。

Laravel Eloquent 是 Laravel 框架自带的 ORM（对象关系映射）系统，它让数据库操作变得像操作 PHP 对象一样简单。你不需要写复杂的 SQL 语句，就能完成增删改查等操作。下面带你快速掌握 Eloquent 的基本用法和常用技巧。

定义模型与数据库表关联

每个 Eloquent 模型对应一张数据库表。默认情况下，模型会自动关联“复数形式”的表名。

例如：

创建一个 User 模型，默认会对应 users 表。

使用 Artisan 命令生成模型：

php artisan make:model User

如果你的表名不是复数，或想自定义表名，可以在模型中指定：

class User extends Model
{
    protected $table = 'my_users'; // 自定义表名
}

还可以设置主键和时间戳字段：

class User extends Model
{
    protected $primaryKey = 'id_user'; // 自定义主键
    public $timestamps = true;         // 是否自动维护 created_at 和 updated_at
    protected $dateFormat = 'U';       // 时间戳格式（如 Unix 时间戳）
}

基本的增删改查操作

Eloquent 提供了简洁的方法进行数据操作。

查询数据

• User::all(); — 获取所有用户
• User::find(1); — 根据主键查找一条记录
• User::where('name', 'John')->get(); — 条件查询，返回集合
• User::where('name', 'John')->first(); — 返回第一条记录
• User::findOrFail(1); — 找不到时抛出 404 异常

新增数据

$user = new User;
$user->name = 'Alice';
$user->email = 'alice@example.com';
$user->save();

或者使用批量赋值（需要在模型中设置 $fillable）：

class User extends Model
{
    protected $fillable = ['name', 'email'];
}

然后这样插入：

User::create(['name' => 'Bob', 'email' => 'bob@example.com']);

更新数据

$user = User::find(1);
$user->name = 'New Name';
$user->save();

也可以直接调用 update：

User::where('active', 1)->update(['status' => 'approved']);

删除数据

$user = User::find(1);
$user->delete();

或通过主键删除：

User::destroy(1);
User::destroy([1, 2, 3]); // 删除多个

条件删除：

User::where('score', '<', 60)->delete();

使用模型关联（关系）

Eloquent 支持多种关联关系，让你轻松处理表之间的连接。

一对一

比如用户（User）有一个人资料（Profile）：

// 在 User 模型中
public function profile()
{
    return $this->hasOne(Profile::class);
}

使用：$user->profile 一对多

用户有多条评论：

// 在 User 模型中
public function comments()
{
    return $this->hasMany(Comment::class);
}

使用：$user->comments 多对多

用户和角色之间是多对多关系，中间表为 role_user：

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

使用：$user->roles，还可以附加数据：$user->roles()->attach($roleId)

访问器与修改器

你可以对字段进行格式化处理。

访问器（获取时处理）

比如将名字首字母大写：

// 在 User 模型中
public function getNameAttribute($value)
{
    return ucfirst($value);
}

修改器（存入时处理）

比如将邮箱统一转为小写：

public function setEmailAttribute($value)
{
    $this->attributes['email'] = strtolower($value);
}

基本上就这些核心内容。Eloquent 功能强大，但上手并不难。只要定义好模型，就可以用面向对象的方式操作数据库，代码更清晰，也更容易维护。

到这里，我们也就讲完了《LaravelEloquent使用教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！