Laravel Eloquent ORM 提供了一种便捷的方式来与数据库交互，本文将详细介绍如何使用 Eloquent 生成模型类。
创建模型类
1. 使用 Artisan 命令
利用 Laravel 的 Artisan 命令行工具，您可以快速创建模型。执行以下命令：
php artisan make:model ModelName
例如，创建一个名为 Post 的模型：
php artisan make:model Post
这会在 app/Models 目录下生成一个 Post.php 文件。
模型的基本结构
一个基本的 Eloquent 模型通常如下所示：
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Post extends Model
{
use HasFactory;
}
2. 同时创建模型和迁移文件
您可以使用以下命令同时生成模型和数据库迁移文件：
php artisan make:model Post -m
这将完成两件事：
- 生成模型文件。
- 生成一个迁移文件，例如
database/migrations/YYYY_MM_DD_HHMMSS_create_posts_table.php。
3. 一步到位：创建模型、工厂、Seeder 和控制器
为了更方便地进行开发，您可以使用以下命令一次性生成模型、工厂、Seeder 和控制器：
php artisan make:model Post -mfsc
其中：
-
-m：生成迁移文件。 -
-f：生成工厂文件。 -
-s：生成 Seeder 文件。 -
-c：生成控制器文件。
模型与数据库表的关系
1. 默认表名约定
Eloquent 默认使用模型类名（复数形式）作为数据库表名。例如：
-
Post模型对应posts表。 -
User模型对应users表。
如果您需要自定义表名，请在模型中设置 $table 属性：
class Post extends Model
{
protected $table = 'blog_posts';
}
模型的重要属性和方法
1. $fillable 和 $guarded
$fillable 或 $guarded 属性用于指定模型中哪些字段可以被批量赋值。
-
$fillable：指定允许批量赋值的字段。
class Post extends Model
{
protected $fillable = ['title', 'content'];
}
-
$guarded：指定不允许批量赋值的字段。
class Post extends Model
{
protected $guarded = ['id'];
}
2. $primaryKey
如果您的主键不是 id，请设置 $primaryKey 属性：
class Post extends Model
{
protected $primaryKey = 'post_id';
}
3. $timestamps
Eloquent 默认使用 created_at 和 updated_at 列记录时间戳。如果您不需要时间戳，请将其设置为 false：
class Post extends Model
{
public $timestamps = false;
}
4. 模型关系
Eloquent 支持多种模型关系：
- 一对一关系 (HasOne):
public function user()
{
return $this->hasOne(User::class);
}
- 一对多关系 (HasMany):
public function comments()
{
return $this->hasMany(Comment::class);
}
- 多对多关系 (BelongsToMany):
public function tags()
{
return $this->belongsToMany(Tag::class);
}
通过以上步骤和属性设置，您可以高效地使用 Laravel Eloquent ORM 来管理您的数据库。
