一个老项目升到 PHP 8.2,某个下单接口开始抛 TypeError: App\Order::setQty(): Argument #1 ($qty) must be of type int, string given。调用方传的是 $_POST['qty'],字符串 "2"。这段代码在 PHP 7.4 上跑了三年没出事,因为弱类型会把 "2" 悄悄转成 2。
变化来自新加的 deClare(strict_types=1)。这个声明按文件生效,写在哪个文件就约束哪个文件里发出的调用,跟被调用方写不写没关系。我一开始以为是被调用的类要加,改了半天没反应,后来才想明白方向反了。
还有个反直觉的点:strict_types 只影响参数和返回值的类型检查,不做隐式转换。int 传给 float 参数是允许的,因为不损失精度;float 传给 int 会直接抛错,哪怕值是 3.0。内部函数也一样,strict 文件里 strlen(123) 抛 TypeError,弱类型文件里返回 3。
<?php
declare(strict_types=1);
$qty = filter_input(INPUT_POST, 'qty', FILTER_VALIDATE_INT);
if ($qty === false || $qty === null) {
throw new InvalidArgumentException('qty invalid');
}
$order = new App\Order();
$order->setQty($qty);
修的时候两种做法。一是入口处显式转换,(int) $_POST['qty'],配 filter_input 加 FILTER_VALIDATE_INT;二是不加 strict_types,靠类型声明做隐式转换。我选了前者,因为下单数量传 "2a" 这种脏数据,弱类型会转成 2,严格模式直接抛错,早点炸比默默算错好。
上线前扫了一遍影响面,grep -rn "strict_types" 找出所有声明过的文件,一共 37 个,重点看它们的调用方传参。真正出问题的只有 6 处,全是表单值直接透传。剩下的都是内部调用,参数本来就对,加严格声明反而把隐患提前暴露了。
