Laravel如何定义数据模型_Laravel模型定义与使用【入门】

ThinkPHP模型定义关键在命名规范与配置匹配：类名User对应表user，文件路径app/model/User.php，命名空间严格遵循PSR-4；表前缀统一在database.php配置，手动指定表名需设protected $table；命名错误或自动加载不匹配将导致查空或Class not found。

模型定义这件事，可远不止“写个类就行”那么简单。真正的关键，在于四个核心配置项是否与真实的数据库表结构严丝合缝地匹配——但凡错一个，create() 就可能静默失败，find() 大概率查不到数据，时间字段更是分分钟给你报错。

模型生成命令要不要加 --migration？

这完全取决于你手头是否已经存在对应的数据表。如果表是现成的（比如从旧系统迁移过来的），那么直接运行 php artisan make:model User 就足够了。反之，如果项目是从零开始，需要新建表，这时候才需要加上 -m 或 --migration 参数。不过要记住，它只是生成一个空的迁移文件，并不会自动执行 migrate 命令。

• 已有表：跳过迁移步骤，把精力集中在模型本身的配置上。
• 新项目且无表：加上 -m，之后记得手动运行 php artisan migrate。
• 一个常见的误区：别指望用类似 --model 的参数从表结构反向生成模型——Lara vel 并不支持这种功能，市面上也没有工具能完美地从数据库表自动生成一个包含正确 $fillable 属性的模型类。

$table 和 $primaryKey 为什么必须核对？

Eloquent 模型默认会按照类名来推导表名（比如 User 对应 users），同时假定主键字段就是 id。一旦实际情况有出入，比如表名其实是 my_users，或者主键是 user_id，而你又没有显式声明，麻烦就来了：

• User::find(1) 实际执行的 SQL 是：SELECT * FROM users WHERE id = 1 → 结果要么查不到数据，要么直接报表不存在。
• User::create([...]) 在插入时会忽略 user_id 字段，可能导致主键冲突或 NULL 值错误。
• 关联查询（例如 $user->posts）也会因为表名或外键不匹配而返回一个空集合。

所以，最稳妥的做法是：打开数据库管理工具，确认真实的表名和主键字段名，然后在模型里明确写死：

protected $table = 'my_users';
protected $primaryKey = 'user_id';

$fillable 填错会导致什么？

必须明确一点：$fillable 是白名单，不是可有可无的配置。只要你使用了 create()、update() 或者批量赋值（$user->fill([...])），就必须在这个数组里列全所有允许写入的字段。漏掉一个，那个字段就永远别想写进数据库，而且系统通常不会给出任何错误提示。

• 典型场景：模型里只写了 'name' 和 'email'，但表里还有个 'a vatar_url' 字段，结果用户头像始终无法保存。
• 安全红线：如果不小心写成了 $guarded = []（即黑名单为空），就等于对所有字段开放写入权限，这为恶意注入（比如伪造 is_admin 字段）敞开了大门。
• 调试技巧：打印 $user->getAttributes() 可以查看哪些字段被成功赋值到了模型实例上，再回头对比你的 $fillable 列表，就能快速定位问题。

$timestamps 设为 false 后还要注意什么？

设置 public $timestamps = false; 确实能避免因找不到 created_at 和 updated_at 字段而引发的报错。但它仅仅关闭了 Eloquent 的自动维护功能，**并不会阻止你手动去写入时间数据**：

• 如果你的表使用的是自定义的时间字段，比如 create_time，那么你需要在模型的 creating 事件监听器中手动赋值：$this->attributes['create_time'] = now()->format('Y-m-d H:i:s');
• 注意不要混用配置：当 $timestamps = false 时，再去设置 const CREATED_AT = 'create_time' 是毫无意义的，因为 Eloquent 根本不会去读取这个常量。
• 时间字段的类型也要匹配：MySQL 的 DATETIME 类型对应 PHP 的 Carbon 对象，而 TIMESTAMP 类型则可能存在时区转换的陷阱，尤其是在本地开发环境和线上服务器时区设置不一致的情况下。

这里有个最容易被忽略的细节：即便关闭了时间戳，当你调用 sa ve() 方法时，Eloquent 仍然会尝试更新所有非主键字段，其中就包括那个你可能没动过的 updated_at —— 如果这个字段在数据库里不允许为 NULL 且没有设置默认值，那么程序就会抛出错误。