Laravel Eloquent怎么用_Laravel Eloquent ORM使用教程

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：

Moonbeam

经过专业培训的 AI 写作助手，可帮助您撰写各类长篇内容。

下载

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);
}