在电商、订单等涉及金额的业务中,价格字段的安全性至关重要。许多开发者习惯在ThinkPHP模型中设置 $readonly = ['price'],认为可以一劳永逸。然而现实情况是,这一配置远非固若金汤,它更像一道“君子协定”,主要依赖调用方的自觉遵守,难以抵御恶意攻击。本文将深入分析为何单独依赖它不
ThinkPHP模型只读字段设置方法:防止价格字段被修改
时间:2026-05-09
浏览:564
文章目录
在电商、订单等涉及金额的业务中,价格字段的安全性至关重要。许多开发者习惯在ThinkPHP模型中设置 $readonly = ['price'],认为可以一劳永逸。然而现实情况是,这一配置远非固若金汤,它更像一道“君子协定”,主要依赖调用方的自觉遵守,难以抵御恶意攻击。本文将深入分析为何单独依赖它不可靠,并阐述真正有效的防护策略应如何构建。

核心结论先行:$readonly 配置仅在模型调用 save() 和 update() 方法时生效。对于直接执行原生SQL、强制赋值、字段名不匹配等情况,它完全无效。要有效防止价格被客户端恶意篡改,必须依赖前置的签名验证与专用的业务方法封装,而不能仅仅依靠模型层的这一“礼貌性忽略”机制。
为何 $readonly = ['price'] 无法阻挡恶意请求
本质上,$readonly 是模型层提供的一个便利性设计,并非核心安全机制。它只在特定的数据写入路径上起作用。以下场景均会导致其防护失效:
- 原生SQL操作:若客户端传入
{"id":123,"price":"999"},而后端直接使用Db::name('order')->update($data)更新数据库,由于未实例化模型,$readonly配置根本不会触发。 - 强制赋值:使用
$model->data($data, true)->save()时,第二个参数true表示强制覆盖,这将跳过包括$readonly在内的所有字段过滤规则。 - 字段名不匹配:若数据库字段为下划线风格的
unit_price,而$readonly数组中填写的是驼峰式unitPrice或全大写UnitPrice,框架在进行字段匹配时会失败,导致防护失效。 - 字段未定义:若前端传递了
price字段,但模型中的$schema或$field属性并未包含该字段,那么$readonly对其同样不起作用。
有效防止价格篡改:前置签名验证是关键
第一道也是最关键的防线,是请求签名验证。此步骤必须在请求进入核心业务逻辑之前完成,通常置于中间件内。这不是可选项,而是必选项。
- 验签原文必须使用原始输入:应使用
$this->request->rawInput()获取原始的JSON字符串,或手动拼接get()与post()参数。避免使用param()方法,因为它会自动合并与过滤参数,可能破坏签名的原始性。 - 规范拼接流程:对除
sign和timestamp外的所有参数,先进行ksort()按键名排序,然后对每个值进行rawurlencode()编码,最后拼接成待签名字符串。 - 时效性与防重放:客户端生成的
timestamp时间戳,服务端应只允许 ±300 秒的偏差。同时,nonce随机字符串需存入Redis并设置600秒过期时间,用于防止同一请求被重复提交。 - 严格拦截:签名一旦验证失败,应立即返回401状态码,且不记录业务日志、不触发任何数据库事务、不执行后续查询,将攻击拦截在最外层。
价格字段更新必须通过专用方法
即使签名验证通过,也不意味着价格字段可以任意修改。业务状态的流转与金额变更,必须封装在专用的方法内,并内置严格的校验逻辑。
- 定义专用方法:例如创建
changePrice($newPrice)方法。在此方法内部,首先校验当前订单状态是否允许调价(例如,可能仅允许在“待支付”状态下修改)。 - 校验价格区间:对新价格进行合理性校验,例如
if ($newPrice 999999.99) { throw new Exception('价格超出允许范围'); }。 - 记录操作日志:调价操作必须留有痕迹。应记录操作人、时间、原始价格与修改后价格,而不仅仅是存储最终结果,这为后续审计与问题追踪提供了依据。
- 慎用模型钩子:避免在
beforeUpdate等模型钩子中硬性判断$data['price']是否变化。因为数据可能在之前的其他钩子中已被修改,且钩子中难以区分此次变更是来自用户提交还是系统内部回调。
数据库与模型层的辅助防护
$readonly 可以保留,但它仅应作为辅助手段。真正的防护重点应放在更底层的约束上。
- 数据库约束:在MySQL 5.7及以上版本,可考虑将
price字段设置为GENERATED ALWAYS AS (...) STORED的生成列,或添加CHECK (price >= 0.01)约束(请注意,MySQL 8.0.16版本才开始严格执行CHECK约束)。 - 精准使用只读字段:模型中的
$readonly最好仅用于那些真正永不更新的字段,例如create_time、source。对于price这类需要通过特定业务逻辑修改的敏感字段,宁可不用$readonly,也不要让它错误地拦截合法的业务流程。 - 确保字段名一致:若确实要使用
$readonly保护price,务必确保字段名与数据库列名完全一致,遵循全小写、下划线分隔的规范。数据库中是unit_price,模型里就必须写['unit_price']。 - 注意关联模型:当关联模型(如商品表
goods)被预载入后,直接修改$model->goods->price再调用save(),主模型的$readonly配置对关联模型是无效的,这是一个容易被忽略的漏洞点。
最后需要指出一个常见矛盾:将 price 加入 $readonly 后,后台运营人员正常的调价接口可能无法工作。而如果API层的签名验证未全面覆盖,一旦接口暴露,价格字段又会成为最显眼的攻击目标。因此,安全防护必须是分层、纵深式的,不能指望一个简单的配置项解决所有问题。从请求验签、业务逻辑封装,到模型约束、数据库兜底,每一层都应恪守其职,共同构建起可靠的价格防篡改体系。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。