PHP 8.3 中 range() 的字符串边界严格按 ASCII 字节处理、空/多字节/多字符字符串触发警告,step 为 0 或方向冲突时抛 ValueError,浮点数需注意精度问题。

PHP 8.2 升级到 8.3 后,range() 函数本身的核心逻辑没有改变,但它的**字符串边界行为和错误提示机制有明确调整**,实际使用中容易触发警告或异常。适配重点不在“怎么用”,而在“怎么避免被新规则打断”。
字符串参数现在严格按字节序列处理
在 PHP 8.2 及更早版本中,如果 start 和 end 是单字符字符串(如 'a' 和 'z'),range() 会生成字母序列;但如果其中一个是数字字符串(如 '1')、另一个是字母(如 'z'),PHP 会尝试隐式转换为整数,有时静默失败或结果异常。
PHP 8.3 起,只要两个边界都是字符串,range() 就**统一按 ASCII 字节值生成字节数组**,不再尝试跨类型转换。例如:
-
range('a', 'c')→['a', 'b', 'c'](正常) -
range('1', '3')→['1', '2', '3'](仍是字符串,不是整数) -
range('a', '3')→ 触发E_WARNING:“非数字字符串多于一个字节”或“因另一边界是数字而隐式转为 int”
空字符串和非法字符串会明确报警告
PHP 8.3 对边界值校验更严格:
立即学习“PHP免费学习笔记(深入)”;
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
range('', 'z')或range('a', ''):发出E_WARNING,并把空字符串当作0处理(不推荐依赖此行为) -
range('α', 'β')(UTF-8 多字节字符):发出E_WARNING,因为不是单字节 ASCII -
range('10', '20'):两个都是数字字符串,但长度 >1 → 发出E_WARNING,且结果可能不符合预期(它按字节而非数值比较)
✅ 正确做法:需要数值范围时,显式转成整数:range((int)'10', (int)'20');需要字母范围时,确保两端都是单字节 ASCII 字符,且类型一致。
step 为 0 或符号与方向冲突时直接抛 ValueError
PHP 8.3 强化了对 step 参数的运行时检查:
-
range(1, 10, 0)→ 抛出ValueError(8.2 可能静默返回空数组或异常) -
range(10, 1, 1)(递减范围却用正 step)→ 抛出ValueError -
range(10, 1, -1)→ 正常,生成[10,9,8,...,1]
✅ 建议在动态构造 range 前加判断:
if ($start <= $end && $step < 0) {
throw new InvalidArgumentException('递增范围不能使用负 step');
}
if ($start >= $end && $step > 0) {
throw new InvalidArgumentException('递减范围不能使用正 step');
}
浮点数边界现在更一致,但需注意精度
当 start、end 或 step 中任意一个是 float,整个序列将按 float 类型生成(8.2 已支持,但 8.3 明确要求 is_finite())。例如:
-
range(1.5, 3.5, 0.5)→[1.5, 2.0, 2.5, 3.0, 3.5] -
range(0.1, 0.3, 0.1)→ 因浮点精度问题,可能多出一项或少一项(这不是 bug,是所有语言共性)
✅ 安全做法:对浮点场景,优先用 for 循环 + 显式计数控制,或用 array_map 配合 range(0, $count-1) 再计算值。


















