ThinkPHP 5.1 防止 API 接口参数篡改的签名算法【防刷】

星敏酱_9396

星敏酱_9396

2026-07-11

835人浏览

原创

根本原因是签名算法漏校验timestamp、nonce未去重、拼接用urlencode而非rawurlencode导致HMAC-SHA256不一致;验签必须在中间件中统一处理,严禁放在控制器内。

thinkphp 5.1 防止 api 接口参数篡改的签名算法【防刷】

ThinkPHP 5.1 项目上线后遭遇批量伪造下单请求,参数被恶意篡改却未被拦截——根本原因不是没加签名,而是签名算法漏掉了 timestamp 校验、nonce 未去重、拼接字符串时用了 urlencode 而非 rawurlencode,导致服务端与客户端算出的 HMAC-SHA256 值永远不一致。

签名验证必须放在中间件里

新建中间件:执行 php think make:middleware CheckApiSign,在 app/middleware.php 中注册,确保它排在路由解析之后、业务控制器之前。

中间件 handle 方法开头就提取签名,失败立即返回 json(['code'=>401,'msg'=>'sign invalid']) 并终止流程,不放行到任何控制器。

【关键】控制器里写验签等于把锁装在屋里——恶意参数已触发日志写入、库存扣减甚至数据库事务,验签失去意义。

统一获取原始参数并归一化

第一步:调用 $raw = $request->getInput() 一次性读取 php://input 流;若为空,则 fallback 到 file_get_contents('php://input')。

第二步:根据 $request->header('content-type') 分支处理:
含 application/json → json_decode($raw, true);
否则 → parse_str($raw, $body)。

第三步:合并参数:$params = array_merge($request->get(), $body ?: []);,再对每个值执行 trim(str_replace(["\r","\n"], '', (string)$v)) 清除隐藏字符。

第四步:剔除非业务字段:unset($params['sign'], $params['signature'], $params['timestamp'], $params['nonce']);,但必须先 isset() 判断是否存在,避免 Notice 报错。

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载

构造签名原文的三要素

方法一:基础拼接(适用于 GET/简单表单)
对 $params 执行 ksort($params, SORT_STRING);
遍历拼接 rawurlencode($k).'='.rawurlencode($v),用 & 连接;
追加 &timestamp=xxx&nonce=yyy(注意:timestamp 必须是客户端传入的 Unix 秒级时间戳);
最后拼上密钥:$data = $query_string . '&timestamp=' . $ts . '&nonce=' . $nonce . '&key=' . config('api.sign_key');。

方法二:带 HTTP 方法和路径(防接口挪用)
取 $method = strtoupper($request->method()); 和 $uri = parse_url($request->url(), PHP_URL_PATH);;
签名原文格式:$method . "\n" . $uri . "\n" . $query_string . "\n";
【关键】换行符必须是 \n,不能是 \r\n,否则哈希值错位。

计算与比对签名

用 hash_hmac('sha256', $data_string, config('api.sign_key'), true) 计算二进制签名,再 base64_encode() 编码为字符串。

从 Header 取签名:$clientSign = $request->header('X-Signature');,绝不用 $request->param('sign')——后者可能被业务参数污染。

用 hash_equals($serverSign, $clientSign) 比对,防止时序攻击;ThinkPHP 5.1 需自行引入该函数或使用 ==(低风险场景)。

校验 timestamp:取 abs(time() - $ts) > 300,超时直接拒掉;nonce 存 Redis:Redis::setex('nonce:' . $nonce, 600, 1),若已存在则验签失败。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

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

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

下载

相关标签:

thinkphp thinkphp 5.1 php

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

相关专题

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

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

2023.10.19

3268

3

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

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

2025.10.17

5569

12

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

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

2025.12.29

3909

9

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

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

2026.01.19

506

15

页面置换算法
页面置换算法

页面置换算法是操作系统中用来决定在内存中哪些页面应该被换出以便为新的页面提供空间的算法。本专题为大家提供页面置换算法的相关文章,大家可以免费体验。

2023.08.14

7276

4

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

热门下载

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

精品课程

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