iniscan Cast 类详解：如何统一 On/Off 与 K/M/G 字节值的比较逻辑

• 应用安全
• 开发工具

iniscan 是一款面向 php.ini 的安全配置扫描工具，它会对服务器 PHP 配置逐项做安全体检。而在这套扫描逻辑的背后，有一个不起眼却至关重要的类——Cast.php。它负责把 php.ini 里五花八门的配置值（On、Off、1、0、2M、128K…）统一转换成标准格式，让"比较"这件事变得可靠。这篇文章带你快速看懂它的两块核心逻辑。

为什么需要"值统一"？php.ini 里的三种方言

打开一份 php.ini，你会发现同一个概念有 N 种写法：

如果扫描规则直接拿字符串做比较，Off和0就会被判定为"不相等"，2M和2097152也会比错。Cast 类就是为了解决这个问题而生的"翻译官"。

castValue：一站式归一化 On/Off 与 0/1

castValue() 方法 的转换规则非常直白：

也就是说，无论 php.ini 里写的是display_errors = Off还是display_errors = 0，经过 Cast 之后都变成了同一个数字0。这样规则里写"value": "0"就能稳定命中两种写法（参见 rules.json 中大量"operation": "equals"的规则定义）。

💡 这个转换发生在比较之前，而不是比较之后——这是 iniscan 规则判定准确的关键。

castPowers：把 K/M/G 换算成完整的字节数

castPowers() 方法 专门处理带后缀的字节值。它内部维护了一张换算表：

实现上用一个正则匹配"数字 + 单个后缀"的格式，命中后就做乘法展开。注意两点细节：

• 必须是纯数字开头 + 单个后缀结尾，像2.5M这种小数不会匹配，会原样返回；
• 它是在castValue()的末尾被自动串联调用的，所以你只要调castValue()一步到位。

实战：一条 "smaller" 规则背后的比较过程

看看 rules.json 中的真实规则：要求memory_limit小于128M。假设你的 php.ini 里写的是：

memory_limit = 256M

判定流程是这样的：

1. 规则基类 Operation.php 在构造时自动注入一个 Cast 实例；
2. OperationSmaller::execute() 取出 php.ini 中找到的256M和规则中的128M；
3. 两边各自经过castValue()转换：268435456与134217728；
4. 数字直接比较，256M > 128M，规则判定FAIL，扫描结果里就会提示"内存限制过大"。

equals、notequals、greater等 其他 Operation 子类 也都走同一条转换链路；自定义规则类（如 Rule.php 中构造时注入的 Cast 实例）同样如此。整个体系因此保持一致：所有比较都发生在"翻译之后"。

测试保障：Cast 的 9 个转换用例

项目为这块逻辑配备了完整的测试文件 CastTest.php，覆盖了：

• ✅Off、空字符串、0、'0'、false→ 全部归为0
• ✅On、'1'、1→ 全部归为1
• ✅ 普通字符串（如thisisatest）原样通过

这套测试保证了"翻译规则"不会因为版本迭代而悄悄漂移，是阅读 iniscan 源码时值得参考的写法：把易错的归一化逻辑抽成独立小类 + 密集的边界测试。

小结：Cast 类的设计亮点

理解了 Cast，你就理解了 iniscan 为什么能把On和1、2M和2097152当作同一回事。接下来可以顺着 Scan.php 看整个扫描流程如何把 php.ini 解析、规则加载与判定结果串起来。

• 应用安全
• 开发工具