ThinkPHP模型只读字段设置方法:防止价格字段被修改

作者:技术拾光时间:2026-05-09 19:04:20浏览:565

在电商、订单等涉及金额的业务中,价格字段的安全性至关重要。许多开发者习惯在ThinkPHP模型中设置 $readonly = ['price'],认为可以一劳永逸。然而现实情况是,这一配置远非固若金汤,它更像一道“君子协定”,主要依赖调用方的自觉遵守,难以抵御恶意攻击。本文将深入分析为何单独依赖它不

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

ThinkPHP模型只读字段设置方法:防止价格字段被修改

核心结论先行:$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层的签名验证未全面覆盖,一旦接口暴露,价格字段又会成为最显眼的攻击目标。因此,安全防护必须是分层、纵深式的,不能指望一个简单的配置项解决所有问题。从请求验签、业务逻辑封装,到模型约束、数据库兜底,每一层都应恪守其职,共同构建起可靠的价格防篡改体系。