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 且没有设置默认值,那么程序就会抛出错误。
相关攻略
最准方法是直接执行SQL检查MorphTo关联:遍历comments等表,用LEFT JOIN或NOT IN验证commentable_type+commentable_id是否指向目标表真实且未软删除的主键,缺失则为脏数据;需补联合索引、绕过Eloquent加载、事务删除。 查出哪些 MorphT
Lara vel 引入 Vite 编译:不是“共存”,而是“替换” 在 Lara vel 项目中引入 Vite,首先要明确一个核心概念:这通常不是“引入”,而是一场彻底的“替换”。关键在于,你需要关闭并移除原有的 Lara vel Mix,否则两个构建工具会同时争夺资源,导致缓存爆炸、热更新(HMR
Lara vel API 登录失败排查指南:从配置到密码的深度检查 登录返回 401 但密码明明正确 遇到这种情况,先别急着怀疑密码。问题的症结,往往不在于密码本身,而在于认证的“关卡”没对上——也就是守卫(guard)配置。Lara vel 的 API 路由默认使用 api 守卫,这套机制默认不读
Lara vel路由缓存清理:一个被低估的“开关” 先明确一个核心事实:route:clear 这个命令,它的职责范围其实非常专一。它只做一件事——删除 bootstrap cache routes php 这个特定的文件。它不会去碰其他缓存,也不会立刻重载路由定义。这意味着什么呢?简单说,当你修改
Lara vel如何做登录验证码图形字体防OCR:扭曲+干扰线增强安全 说到登录验证码,核心目标就一个:拦住机器,放过真人。但现实往往是,要么用户抱怨“看不清”,要么后台发现验证码形同虚设。问题出在哪?很多时候,不是功能没做,而是防OCR的关键细节没做到位。今天就来聊聊,如何通过配置Lara vel
热门专题
热门推荐
小米Note 3铃声管理全攻略:从定位到自定义,一步到位 手里拿着小米Note 3,想换个铃声却找不到地方?别急,这事儿其实比想象中简单。系统预置的铃声,都规规矩矩地躺在内部存储的一个特定文件夹里:SDcard MIUI ringtone 。这个目录就像MIUI系统的“声音仓库”,里面分门别类地存放
小米电饭煲重置网络提示失败怎么回事? 遇到小米电饭煲重置网络总是失败,先别急着怀疑是硬件坏了。这事儿本质上,是设备在配网流程中没能和路由器成功“握手”,建立通信授权。背后的原因,往往出在几个容易被忽略的细节上:比如Wi-Fi频段没选对、密码格式太复杂、App里还残留着旧配置,或者是路由器那边设置了“
按摩椅力度调小后依然有效,关键在于匹配个体身体状态与使用需求 现代中高端按摩椅普遍配备多级力度调节系统,但很多人心里犯嘀咕:力度调小了,是不是就变成隔靴搔痒,没什么实际作用了? 事实恰恰相反。实测数据显示,轻柔档位(比如30%—50%的输出强度)在缓解日常肩颈僵硬、改善浅层血液循环方面,有着明确的生
米家扫地机器人怎么用手机远程控制 想随时随地指挥家里的扫地机器人干活?这事儿其实很简单。米家APP就是你的万能遥控器,只要几步设置,无论你是在公司、在出差,还是躺在沙发上,都能稳定、便捷地通过手机远程掌控全局。操作逻辑很清晰:在手机上安装好官方米家APP并登录你的小米账号,让扫地机器人连上家里的Wi
PoE交换机好坏,普通测线仪说了不算 想用普通网线测线仪来判断一台PoE交换机的好坏?这个想法很危险。原因很简单:普通测线仪只能干些基础活儿,比如看看网线通不通、线序对不对、有没有短路断路。但对于PoE交换机的核心能力——供电电压是否达标、输出功率稳不稳定、是否兼容最新的IEEE标准、带载后电压会不





