登录
首页 >  文章 >  php教程

Laravel模型如何定义_Laravel创建Eloquent模型【基础】

时间:2026-05-05 23:39:42 499浏览 收藏

珍惜时间,勤奋学习!今天给大家带来《Laravel模型如何定义_Laravel创建Eloquent模型【基础】》,正文内容主要涉及到等等,如果你正在学习文章,或者是对文章有疑问,欢迎大家关注我!后面我会持续更新相关内容的,希望都能帮到正在学习的大家!

模型生成后必须检查表名、主键、时间戳三件事:设 $table 指定真实表名,$primaryKey 指定主键字段,$timestamps=false 关闭自动时间戳。

Laravel模型如何定义_Laravel创建Eloquent模型【基础】

直接用 php artisan make:model 生成,再根据表名、字段、关联等实际结构补配置,别指望默认推导全对。

模型文件生成后必须检查的三件事

Artisan 命令生成的模型只是骨架,Laravel 默认按类名复数小写推导表名(Userusers),但真实项目里几乎总会打破这个约定:

  • 旧库表名是 user_infotbl_user?立刻在模型里加 protected $table = 'user_info'; —— 写成 $tableName$table_name 都无效
  • 主键不是 id?比如是 uidarticle_id,得补 protected $primaryKey = 'uid';
  • 不需要自动维护 created_at/updated_at?关掉:public $timestamps = false;,否则插入时会因字段不存在报错

批量赋值字段必须显式声明 $fillable$guarded

没声明 $fillable 就调 create()update(),字段直接被忽略,不报错也不提示,查半天发现数据没进去——这是最常踩的静默坑:

  • 只允许填 titlecontentprotected $fillable = ['title', 'content'];
  • 想“除了 password 全都可填”,用 $guarded = ['password'];,但注意它和 $fillable 互斥,不能共存
  • 别把字段名拼错,比如 'is_active' 写成 'isactive',Eloquent 不校验,赋值时就丢掉了

关联方法写错,with() 就是摆设

with('author') 返回空或报错,大概率不是语法问题,而是外键没对齐:

  • belongsTo 必须写在外键所在模型里:如果 posts 表有 author_id 字段,那就在 Post 模型里写 belongsTo(User::class, 'author_id')
  • hasMany 的第二参数是外键名,不是本地键:hasMany(Comment::class, 'post_id'),不是 'id'
  • 中间表命名不规范?belongsToMany(Role::class, 'user_role', 'user_id', 'role_id') 四个参数一个都不能少,漏了就查不到数据

类型转换($casts)依赖数据库字段真实类型

$casts = ['is_active' => 'boolean'] 看着很爽,但底层会把 "1" 转成 true 再存进数据库——如果字段类型是 VARCHAR,存进去就是字符串 "1";如果是 TINYINT(1),才能真正存成数字 1

  • json 字段必须配 $casts = ['meta' => 'array'],且数据库类型得是 JSON(MySQL 5.7+)或 TEXT(低版本 fallback)
  • $casts 里写了不存在的字段名,Eloquent 不警告,取值时直接返回 null,很难排查
  • 前端传 "is_active": "1",后端想转布尔又怕存错,优先改数据库字段为 TINYINT(1),再配 'boolean' cast

模型不是写完就完事的代码块,它是数据库结构在 PHP 层的镜像。表名、主键、时间戳、填充白名单、类型转换、关联外键——每个配置项背后都对应着真实的数据约束,漏掉一个,运行时就可能静默失败或查不到数据。

以上就是《Laravel模型如何定义_Laravel创建Eloquent模型【基础】》的详细内容,更多关于的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>