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

TP8.0 实现 API 接口参数的白名单过滤机制【安全】

老辰小哥_6659

老辰小哥_6659

发布时间:2026-07-09 16:08:58

|

971人浏览过

|

来源于php中文网

原创

ThinkPHP 8.0需通过allowField()字段白名单、Validate双重校验及ParamWhitelistMiddleware中间件三重防护拦截非法参数:先用allowField()限定入库字段,再用验证器场景与规则校验字段存在性及内容安全,最后由前置中间件统一校验请求参数键名合法性。

tp8.0 实现 api 接口参数的白名单过滤机制【安全】

需要让ThinkPHP 8.0的API接口只接收明确允许的参数字段,防止攻击者通过提交非法字段(如id、status、is_admin)绕过业务校验直接写入数据库,造成越权或数据污染。

用模型allowField()做字段级白名单拦截

第一步:在控制器中实例化模型后,立即调用allowField()并传入预设字段数组,例如$user = new User(); $user->allowField(['username', 'email', 'mobile'])->save($data);

第二步:确保白名单数组来自可信来源——不能直接用$_POST或$request->param()原始数据拼装,必须从配置文件读取或数据库查出后经清洗验证;【数据库查出的字段若含空格、换行或重复项,allowField会静默失效】

第三步:检查字段是否真实存在于当前数据表结构中,执行(new User())->getSchema()->getFields()获取合法字段列表,过滤掉白名单里不存在的字段名。

这一步操作起来很简单,直接把文件拖进去就行。

结合Validate验证器做字段存在性+规则双重白名单

方法一:在验证器类的$scene定义中显式列出该场景下允许出现的所有字段名,漏写=不校验也不保证存在。例如register场景必须写protected $scene = ['register' => ['username', 'email', 'mobile']];

ThinkPHP5.1企业站点快速开发-源码课件
ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

方法二:在验证规则中为每个字段绑定filter,如'username' => 'require|alphaNum|htmlspecialchars',避免字段存在但内容危险。

注意:validate校验通过后,仍需配合allowField()二次过滤——因为验证器不管字段是否入库,只管规则;而allowField()管入库字段,不管内容安全。

通过中间件统一拦截非法参数键名

创建ParamWhitelistMiddleware中间件,在handle方法中获取$request->param()结果,遍历所有键名,比对预设白名单数组,发现非法键名立即抛出400异常并终止请求。

白名单数组建议从config/api.php中读取,例如'allowed_params' => ['page', 'limit', 'sort', 'keyword'],避免硬编码在中间件内。

这一步必须放在app/middleware.php全局中间件数组最前面,否则路由分发后参数已进入控制器,拦截失去意义。

热门AI工具

更多
UpDream
UpDream Hot

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

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

Lovart
Lovart Hot

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

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3088

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

4609

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3729

2025.12.29

java接口相关教程
java接口相关教程

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

426

2026.01.19

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

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

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

120

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

100

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

80

2026.09.30

热门下载

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

精品课程

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

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