讲师中心 微信公众号
AI工具推荐 视频效率加速

Eloquent作用域(Scope)、访问器与修改器高级用法

浅瑶君_8659

浅瑶君_8659

发布时间:2026-05-19 11:21:36

|

650人浏览过

|

来源于php中文网

原创

作用域方法须以scope开头、public且返回$query;全局作用域需实现Scope接口并在booted()注册;访问器/修改器基于属性名驼峰转换,仅作用于PHP层,不影响SQL查询。

eloquent作用域(scope)、访问器与修改器高级用法

scope 方法名必须以 scope 开头,调用时去掉前缀转驼峰

本地作用域本质是模型里的普通 public 方法,但 Laravel 会识别 scope 前缀并自动挂载为查询链可调用的方法。方法第一个参数固定是 $query(Illuminate\Database\Eloquent\Builder 实例),返回值必须是该 $query 对象本身(支持链式)。

常见错误:漏掉 return $query,导致后续调用报错“Call to a member function get() on null”;或者把方法写成 private 或 protected,Laravel 就找不到它。

  • 定义正确写法:public function scopeActive($query) { return $query->where('status', 'active'); }
  • 调用方式:User::active()->get(),不是 User::scopeActive()->get()
  • 带参数的作用域:public function scopeWhereTitle($query, $title) { return $query->where('title', 'like', "%{$title}%"); },调用:Post::whereTitle('Eloquent')->get()
  • 多个作用域可链式组合:Post::published()->whereTitle('Scope')->orderBy('created_at')->get()

全局作用域需实现 Scope 接口,并在 booted() 中注册

全局作用域不是模型方法,而是一个独立类,必须实现 Illuminate\Database\Eloquent\Scope 接口,且只实现 apply() 方法。它会在所有该模型的查询中自动生效——包括 find()、first()、count(),甚至关联预加载里的子查询。

容易踩的坑:直接在 boot() 里注册,但 boot() 可能被多次调用;应改用 booted()(静态方法,只执行一次)。另外,忘记移除全局作用域会导致调试困难,比如软删除后查不到数据却没报错。

Laravel Creem Agent
Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品,执行心跳检查,管理本地 Laravel支付商店。

下载
  • 注册方式:protected static function booted() { static::addGlobalScope(new ActiveScope); }
  • 临时跳过:User::withoutGlobalScopes()->get() 或指定某一个:User::withoutGlobalScope(ActiveScope::class)->get()
  • 软删除(SoftDeletes)就是靠全局作用域实现的,它自动加 where null on deleted_at 条件

访问器 get{Attribute}Attribute 和修改器 set{Attribute}Attribute 匹配字段名有转换规则

访问器和修改器的命名不是直接对应数据库字段,而是基于「属性名」——即模型里通过 $fillable 或动态访问的键名。Laravel 把蛇形字段(如 user_name)自动转为驼峰(userName),再拼上前缀构成方法名。

这个转换容易误判:比如字段叫 is_admin,对应修改器是 setIsAdminAttribute(),不是 setIsadminAttribute();若字段含多个下划线(first_name_last_name),会变成 firstNameLastName,但这种命名本身就不推荐。

  • 修改器只在模型赋值时触发:$user->user_name = 'ABC' 或 User::create(['user_name' => 'ABC']),对 DB::table()->update() 完全无效
  • 访问器只在读取时触发:echo $user->user_name,但 $user->attributes['user_name'] 绕过访问器,直接拿原始值
  • 时间字段别硬写修改器:setCreatedAtAttribute() 是危险操作,应改用 $casts = ['created_at' => 'datetime']

作用域和访问器/修改器互不干扰,但组合使用时要注意执行时机

作用域影响 SQL 查询条件,发生在数据库层面;访问器/修改器只处理 PHP 层的数据进出,不参与生成 WHERE 或 SELECT 字段。这意味着:你在作用域里用 where('user_name', 'john'),匹配的是数据库原值;而 $user->user_name 输出的却是访问器加工后的结果——两者根本不在同一层。

一个典型陷阱:定义了 setUserNameAttribute() 把输入转小写存库,又定义了 getUserNameAttribute() 把输出首字母大写。这时你用 User::where('user_name', 'John')->first() 查不到记录,因为库里存的是 john,但你却按 John 去查。

  • 搜索场景下,如果业务要求“忽略大小写查用户名”,应在作用域里统一处理:$query->whereRaw('lower(user_name) = ?', [strtolower($name)])
  • 不要指望修改器能改变查询行为——它只改写入值,不改查询条件
  • 全局作用域 + 修改器组合时,尤其注意软删除字段(deleted_at)是否也被其他修改器意外覆盖

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

9984

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5941

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2075

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3708

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3471

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4937

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3862

2023.11.13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 197人学习

Composer手册
Composer手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn