PHP Academy · 课时

Eloquent 模型与迁移

Q: 「Eloquent 模型与迁移」这节课中我会学到什么？

使用 Artisan 命令生成模型和数据库迁移。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 Artisan 命令生成模型和数据库迁移。

Eloquent 模型与迁移 是 CoddyKit 上的免费 PHP Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

什么是 Eloquent

Eloquent 是 Laravel 的 ActiveRecord ORM。每个数据库表都有对应的 Model 类，该类表示一行数据并提供查询方法。

生成模型

使用 Artisan 创建模型。添加 -m 还可以同时生成迁移文件。

$ php artisan make:model Post -m
# Creates:
# app/Models/Post.php
# database/migrations/xxxx_create_posts_table.php

模型类

最基本的 Eloquent 模型只需继承 Model。Eloquent 会根据类名推断表名（复数形式的 snake_case）。

<?php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $fillable = ["title", "body", "user_id"];
}

迁移文件

迁移用于定义表结构。运行 php artisan migrate 应用迁移。

<?php
public function up(): void
{
    Schema::create("posts", function (Blueprint $table) {
        $table->id();
        $table->string("title");
        $table->text("body");
        $table->foreignId("user_id")->constrained()->cascadeOnDelete();
        $table->timestamps();
    });
}

运行迁移

将待处理的迁移应用到数据库。

$ php artisan migrate
# Rollback:
$ php artisan migrate:rollback
# Fresh (drop all and re-migrate):
$ php artisan migrate:fresh

$fillable 与 $guarded

$fillable 将允许批量赋值的列列入白名单。$guarded 将列列入黑名单。在生产环境中，除非经过慎重考虑，否则不要设置 $guarded = []。

<?php
// Whitelist approach (recommended):
protected $fillable = ["title", "body"];

// Blacklist approach:
protected $guarded = ["id", "created_at"];

类型转换

$casts 属性会自动将列值转换为 PHP 类型。

<?php
protected $casts = [
    "is_published" => "boolean",
    "metadata"     => "array",       // JSON column
    "published_at" => "datetime",
];

隐藏与可见

$hidden 属性会在 JSON 或数组序列化时排除指定列，适合用于密码和令牌。

<?php
protected $hidden = ["password", "remember_token"];

自定义表名

使用 $table 属性覆盖默认表名。

<?php
protected $table = "blog_posts"; // instead of "posts"

软删除

添加 SoftDeletes trait 和 deleted_at 列。记录不会被真正删除，而是标记删除时间戳，并从普通查询中排除。

<?php
use Illuminate\Database\Eloquent\SoftDeletes;

class Post extends Model {
    use SoftDeletes;
}

时间戳

默认情况下，Eloquent 会管理 created_at 和 updated_at 列。设置 $timestamps = false 可将其禁用。

总结

Eloquent 模型映射到数据库表。使用 Artisan 可以同时生成模型和迁移。定义 $fillable 以确保批量赋值安全。使用 $casts 实现自动类型转换。

快速检查

哪个 Artisan 选项可以在生成模型的同时生成迁移？

常见问题解答

「Eloquent 模型与迁移」课时是免费的吗？

是的 — 「Eloquent 模型与迁移」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「Eloquent 模型与迁移」这节课中我会学到什么？

使用 Artisan 命令生成模型和数据库迁移。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Eloquent 模型与迁移」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy