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

Laravel如何做模型查询排除字段_Laravelselect时忽略某些列【介绍】

云静小哥_4607

云静小哥_4607

发布时间:2026-05-04 06:16:00

|

811人浏览过

|

来源于php中文网

原创

应主动用 select() 明确指定查询字段,而非依赖 select('*') 或默认全查,以避免敏感/大字段泄露、提升性能;关联字段需加表前缀,with() 中的 select() 需单独设置;$hidden/makeHidden 控制序列化输出,不替代查询过滤;DB::table() 无模型隐藏机制,须靠 select() 严格控制;addSelect() 仅用于追加计算字段,不可替代主 select()。

laravel如何做模型查询排除字段_laravelselect时忽略某些列【介绍】

select() 明确指定字段,而不是靠 select('*') 或默认查询

Laravel 默认用 get() 会查出所有字段,但实际业务里常有敏感字段(如 passwordapi_token)或大文本字段(如 contentdescription)不该返回。靠“排除”思维写代码容易漏、难维护,Laravel 本身也不提供类似 exclude() 的原生方法。

正确做法是:主动列出需要的字段。这既是性能优化(减少网络传输和内存占用),也避免意外暴露数据。

  • select() 必须在 get() 前调用,顺序错了无效
  • 别写 select('id', 'name', '*') —— * 会覆盖前面的字段,且不同数据库行为不一致
  • 关联模型的字段要显式加表前缀,比如 users.nameposts.title,否则可能冲突或报错
  • 如果用了 with() 预加载,select() 只影响主模型,不影响关联模型的字段;想控制关联字段,得在闭包里单独写 select()
Post::select('id', 'title', 'slug', 'created_at')
    ->with(['author' => function ($q) {
        $q->select('id', 'name', 'avatar');
    }])
    ->get();

makeHidden()$hidden 控制序列化输出,不是查询时过滤

很多人想“查询时就去掉 password”,结果在 select() 里漏掉它,却发现 API 返回里还是有 —— 因为 Eloquent 模型从数据库读出来后,只要属性存在(哪怕没查),序列化时仍可能被包含。这时候该用隐藏机制,而非查询过滤。

$hidden 是静态属性,适合全局固定规则;makeHidden() 更灵活,适合单次响应动态控制。

Laravel
Laravel

避免常见的Laravel错误:N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载
  • $hidden = ['password', 'remember_token'] 写在模型里,对所有 toArray() / toJson() 生效
  • $model->makeHidden(['api_token']) 只影响当前实例,适合不同接口返回不同字段
  • 注意:如果字段根本没查出来(比如没写进 select()),makeHidden() 就没意义——它只影响已加载到内存的属性
  • 别把 $hidden 和数据库权限混为一谈:它不阻止你访问 $user->password,只是不输出

警惕 DB::table()Query Builder 的字段歧义

DB::table('users') 时没有模型层的 $hidden 机制,全靠 select() 控制字段。但这里更容易踩坑:比如 JOIN 多表时字段名重复,或忘记给字段加别名导致覆盖。

  • JOIN 查询必须用 select('users.id as user_id', 'posts.title') 这类明确别名,否则 id 字段可能被覆盖
  • DB::table()->pluck('name') 返回的是值数组,不是模型,不存在隐藏逻辑,也无需考虑 $hidden
  • 如果后续要转成模型(比如用 fromQuery()),字段名必须和模型属性完全匹配,否则赋值失败
  • DB::raw() 时字段名不会自动识别,select(DB::raw('COUNT(*) as total')) 中的 total 必须手动取,不能指望模型映射

复杂查询下,select()addSelect() 的分工要清楚

addSelect() 不是“再选几个字段”,而是为已有查询追加计算字段或子查询字段,常用于统计、分组、条件判断等场景。它和 select() 共存时,顺序和意图必须清晰,否则结果不可控。

  • select('id', 'name') 定义主字段集;addSelect(DB::raw('COUNT(comments.id) as comment_count')) 是补充字段,需配合 leftJoin()groupBy()
  • 不能只写 addSelect() 不写 select(),否则主键等基础字段可能丢失,导致集合无法正常遍历
  • addSelect() 的字段不会出现在模型的 $casts$appends 中,它是原始查询结果的一部分,类型由数据库返回决定
  • 如果用了 distinctaddSelect() 的字段必须也在 SELECT 列表中参与去重,否则 MySQL 8.0+ 会报错

真正麻烦的不是语法怎么写,而是得时刻分清:这个字段要不要进内存?要不要进 JSON?要不要参与后续逻辑?三者目标不同,手段也不同 —— 查不到、取不到、吐不出,得各走各的路。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

WorkBuddy

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Laper
Laper Hot

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

讯飞绘文

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

817

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

795

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2348

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

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

3261

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

4530

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

3036

2025.08.05

laravel面试题
laravel面试题

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

5829

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1336

2026.03.04

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

热门下载

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

精品课程

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

共1课时 | 179人学习

Composer手册
Composer手册

共0课时 | 0人学习

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

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