Laravel中在迁移文件和模型中设置主键有何区别?
针对Laravel Eloquent主键配置的常见疑问解答
$primaryKey配置到底是干什么的
这个配置纯粹是ORM层的映射规则,和数据库本身的结构没有任何关系。
Laravel Eloquent默认有一套固定约定:它默认认为每个模型对应的数据表,都存在一个名为id的自增主键,所有查单条记录、删除单条数据、更新单条内容、关联匹配、路由模型绑定这类依赖唯一标识的操作,都会默认拿这个id当查询条件。
如果你的表实际主键根本不叫id,就需要手动在模型里写protected $primaryKey = 'xxx',相当于给ORM递个明确提示:“别默认找id字段了,这张表真正用来当唯一标识的字段是xxx”。
用实际的SQL生成对比就能直观理解:
- 不配置该参数时,执行
Flight::find(1)生成的SQL为:select * from flights where id = 1 - 配置
protected $primaryKey = 'flight_id'后,同样执行Flight::find(1),生成的SQL会变成:select * from flights where flight_id = 1
先靠迁移建表,再写这个模型配置会有什么影响
结果完全取决于迁移定义的表结构和模型配置是否对齐:
- 如果你的迁移文件建表的时候,真的把
flight_id设成了表的实际主键(比如迁移里写了$table->bigIncrements('flight_id')),那这个配置就是完全适配的,所有ORM功能可以正常运行,不会出现任何异常。 - 如果你的迁移里建表的时候,根本没把
flight_id当主键——比如表实际主键还是默认的id,flight_id只是个存业务数据的普通字段,那这个配置就相当于给ORM指错了方向:所有依赖主键的操作都会拿着这个普通字段当唯一标识去查,轻则查不到数据,重则更新错记录、因为字段重复值触发数据库报错。
这个模型配置会不会修改数据库的实际主键
完全不可能。
Eloquent模型里写的所有配置,都只是告诉PHP代码怎么和已经存在的数据库表对接,它没有权限、也没有内置逻辑去主动修改数据库里的表结构、主键约束、索引这些底层定义。数据库表的实际结构、主键设置,从你跑完迁移、或者手动在数据库调整完的那一刻就已经固定,模型配置顶多是“让ORM代码适配这个已定的结构”,绝对不会反过来修改表本身的定义。
新手最容易踩的坑:把模型配置和迁移的作用搞混。迁移是负责“在数据库里建出你定义的表结构”,模型配置是负责“让ORM代码能正确读懂这个表结构”,两边的定义必须保持一致,模型本身根本没有改造表结构的能力。
内容的提问来源于stack exchange,提问作者H. Akkaya
相关产品推荐
相关产品推荐

