0

0

thinkphp查询作用域(scope)如何简化查询

冰火之心

冰火之心

发布时间:2025-09-29 23:26:03

|

576人浏览过

|

来源于php中文网

原创

答案:ThinkPHP的查询作用域通过定义scope方法封装常用查询条件,支持无参、带参及默认全局作用域,可组合调用或链式使用,有效减少重复代码,提升模型可维护性。

thinkphp查询作用域(scope)如何简化查询

ThinkPHP 的查询作用域(scope)是一种封装常用查询条件的方式,能有效减少重复代码,提升模型的可维护性。通过定义作用域,你可以把经常用到的查询逻辑集中管理,在需要时直接调用。

1. 定义查询作用域

在模型类中通过 scope 开头的方法定义作用域。方法接收查询对象作为参数,可链式调用。

例如,用户模型中常见的“只查启用状态”和“按创建时间排序”:

class User extends Model
{
    // 定义作用域:启用状态
    public function scopeActive($query)
    {
        $query->where('status', 1);
    }

    // 定义作用域:按创建时间倒序
    public function scopeLatest($query)
    {
        $query->order('create_time', 'DESC');
    }
}

2. 使用作用域简化查询

定义后,可通过 使用 scope 方法调用多个作用域,组合出完整查询。

立即学习PHP免费学习笔记(深入)”;

// 调用多个作用域
User::scope('active,latest')->select();

// 等同于
User::where('status', 1)->order('create_time', 'DESC')->select();

也可以直接链式调用作用域方法(需开启动态调用):

新快购物系统
新快购物系统

新快购物系统是集合目前网络所有购物系统为参考而开发,不管从速度还是安全我们都努力做到最好,此版虽为免费版但是功能齐全,无任何错误,特点有:专业的、全面的电子商务解决方案,使您可以轻松实现网上销售;自助式开放性的数据平台,为您提供充满个性化的设计空间;功能全面、操作简单的远程管理系统,让您在家中也可实现正常销售管理;严谨实用的全新商品数据库,便于查询搜索您的商品。

下载
User::active()->latest()->select();

3. 带参数的作用域

作用域支持传参,适用于动态条件。

public function scopeType($query, $type)
{
    $query->where('type', $type);
}

public function scopeKeyword($query, $keyword)
{
    $query->where('name', 'like', "%{$keyword}%");
}

调用方式:

User::scope('type:1,keyword:张')->select();
// 或
User::type(1)->keyword('张')->select();

4. 默认作用域(全局作用域)

如果希望某个条件每次查询都自动加上,可定义默认作用域。

public static function base($query)
{
    $query->where('is_delete', 0); // 假设软删除字段
}

这样,所有对该模型的查询都会自动过滤掉已删除数据。

基本上就这些。合理使用作用域能让代码更清晰,避免到处写重复的 where 条件,尤其适合权限、状态、租户等通用筛选场景。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

371

2024.04.10

thinkphp性能怎么样
thinkphp性能怎么样

thinkphp 是一款高性能的 php 框架,具备缓存机制、代码优化、并行处理和数据库优化等优势。官方性能测试显示,它每秒可处理超过 10,000 个请求,实际应用中被广泛用于京东商城、携程网等大型网站和企业系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

321

2024.04.10

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

3

2026.01.21

无人机驾驶证报考 uom民用无人机综合管理平台官网
无人机驾驶证报考 uom民用无人机综合管理平台官网

无人机驾驶证(CAAC执照)报考需年满16周岁,初中以上学历,身体健康(矫正视力1.0以上,无严重疾病),且无犯罪记录。个人需通过民航局授权的训练机构报名,经理论(法规、原理)、模拟飞行、实操(GPS/姿态模式)及地面站训练后考试合格,通常15-25天拿证。

14

2026.01.21

Python多线程合集
Python多线程合集

本专题整合了Python多线程相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.21

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

3

2026.01.21

windows激活码分享 windows一键激活教程指南
windows激活码分享 windows一键激活教程指南

Windows 10/11一键激活可以通过PowerShell脚本或KMS工具实现永久或长期激活。最推荐的简便方法是打开PowerShell(管理员),运行 irm https://get.activated.win | iex 脚本,按提示选择数字激活(选项1)。其他方法包括使用HEU KMS Activator工具进行智能激活。

2

2026.01.21

excel表格操作技巧大全 表格制作excel教程
excel表格操作技巧大全 表格制作excel教程

Excel表格操作的核心技巧在于 熟练使用快捷键、数据处理函数及视图工具,如Ctrl+C/V(复制粘贴)、Alt+=(自动求和)、条件格式、数据验证及数据透视表。掌握这些可大幅提升数据分析与办公效率,实现快速录入、查找、筛选和汇总。

6

2026.01.21

热门下载

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

相关下载

更多

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 3.3万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

NumPy 教程
NumPy 教程

共44课时 | 3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号