PHP 8.0 起 substr() 永远返回 string（如越界时返""），而 PHP 7.x 可能返 false；应避免用 === false 判断，改用 $res !== '' 或 strlen($res) > 0，并优先升级调用逻辑而非封装兼容函数。
substr 在 PHP 8.0 和 7.x 的返回值差异
PHP 8.0 起，substr() 的返回类型被严格定义为 string，不再可能返回 false；而 PHP 7.x（尤其是 7.4 及更早）在某些边界条件下（如 offset 超出字符串长度、length 导致无效截取）会返回 false。这不是 bug，是语言层行为变更。
典型触发场景包括：substr("abc", 5)、substr("abc", 2, -5)、substr("", 0, 1)。这些在 PHP 7.x 返回 false，在 PHP 8.0 返回空字符串 ""。
用类型判断代替布尔判断，避免逻辑断裂
很多老代码习惯写 if (substr($s, 0, 3) == 'abc') 或 if (!substr($s, 0, 3))，这类写法在 PHP 8.0 下不会报错但语义已变：空字符串 "" 是 “falsy”，而 false 也是 “falsy”，但两者类型不同，且在 strict 比较或函数参数传递中表现不一致。
- 不要用
=== false判断是否失败 —— PHP 8.0 永远不会返回false，该判断在新版下永远为false - 不要用
== ''或empty()做“是否截取成功”判断 —— 空字符串可能是合法结果（如截取长度为 0），也可能是失败信号（PHP 7.x 下） - 正确做法是：**只依赖返回值本身，按字符串语义使用**。例如需要非空前缀时，显式检查
strlen($res) > 0或$res !== ''
兼容性封装：统一返回行为的 substr_safe()
若项目需同时支持 PHP 7.4 和 8.0+，且存在大量依赖 false 表示“无效截取”的旧逻辑，可封装一个行为一致的替代函数：
立即学习“PHP免费学习笔记（深入）”；
function substr_safe(string $string, int $offset, ?int $length = null): string
{
$result = substr($string, $offset, $length);
// PHP 7.x 可能返回 false；PHP 8.0 总是 string
return is_string($result) ? $result : '';
}
这个封装消除了版本差异，但要注意：
- 它掩盖了原始错误条件（如越界），所以仅用于“容错截取”，不适用于需精确诊断位置错误的场景
- 若原逻辑靠
false触发 fallback 分支，现在要改用''判断，且需确认空字符串在业务中是否真代表“无意义” - 不要对
$offset或$length做自动修正（如转正、截断），那会改变语义 —— 封装的目标是统一输出类型，不是重写逻辑
更推荐的做法：直接升级调用方逻辑
比起封装函数，更可持续的方式是清理调用点：
- 搜索项目中所有
substr(调用，重点检查后跟=== false、== false、!substr(...)的地方 - 把“失败即空”的假设显式化：比如
$prefix = substr($s, 0, 3) ?: '';，既兼容 PHP 7.x 的false，也兼容 PHP 8.0 的"" - 对关键路径（如路由解析、协议头提取）加单元测试，覆盖
substr边界输入，确保空字符串处理逻辑符合预期
PHP 8.0 的 substr 行为更可预测，强行维持 false 返回反而增加维护成本。真正容易被忽略的是那些隐式依赖“false 表示越界”的条件分支 —— 它们在 PHP 8.0 下静默失效，比报错更危险。
