substr_compare在PHP 8.0+中$offset越界触发ValueError（属Error），无法被Exception捕获，需catch(ValueError)或Throwable；推荐预校验offset合法性避免异常。
substr_compare 第三个参数 $offset 越界直接 fatal，没法 try/catch
substr_compare() 在 PHP 8.0+ 中，当 $offset 超出字符串长度（正数越界）或绝对值大于字符串长度（负数越界）时，**不抛出 Exception，而是触发 ValueError（属于 Error 类型）**。这意味着它无法被 catch (Exception $e) 捕获，脚本会直接终止，除非你明确捕获 Error 或其子类。
- 常见错误现象：
substr_compare("abc", "def", 10)报Fatal error: Uncaught ValueError: substr_compare(): Argument #3 ($offset) must be contained in string - 这不是 warning，也不是 deprecated，是不可恢复的
Error—— 和调用不存在函数同级严重性 - PHP 8.0 严格区分
Error（如ValueError、TypeError）和Exception；substr_compare的越界检查属于前者 - 即使你写了
try { substr_compare(...); } catch (Exception $e) { }，也完全无效
正确捕获方式：必须用 catch(Throwable) 或显式 catch(ValueError)
要真正拦截这个错误，只能靠 Throwable（PHP 7.0+ 所有可抛出对象的基类），或更精确地捕获 ValueError：
- 推荐写法：
try { substr_compare($a, $b, $offset); } catch (ValueError $e) { /* 处理越界 */ } - 兜底写法：
catch (Throwable $e)，但需注意它也会捕获FatalError等真正致命错误，建议加类型判断再处理 - 别用
set_error_handler()—— 它只管E_WARNING等传统错误，对ValueError无效 - PHP 8.0+ 不支持
@抑制符屏蔽ValueError，加了也没用，还会掩盖真实问题
更安全的替代方案：先校验 offset 再调用
比起依赖异常捕获，提前判断 $offset 合法性更轻量、更可控：
- 正数
$offset：要求$offset <= strlen($main_str)（注意是 ≤，因为substr_compare("a","b",1)允许在末尾“空位置”比较，此时返回 0） - 负数
$offset：要求abs($offset) <= strlen($main_str)（例如"abc"长 3，$offset = -3合法，-4就越界） - 可封装成校验函数：
if (!is_valid_offset($str, $offset)) { /* 返回默认值或 throw 自定义 Exception */ } - 这样避免了异常开销，也绕开了
ValueError必须用Throwable捕获的限制
为什么 strlen(null) 和 substr_compare 越界都报 ValueError？
这是 PHP 8.0 类型系统收紧的一致行为：所有内置函数对「明显非法参数」统一升级为 ValueError。比如 strlen(null) 在 8.1+ 报 deprecated，但在 8.0+ 对非字符串输入（如 strlen([])）就直接 ValueError。而 substr_compare 的 $offset 越界，本质上也是“参数值语义非法”，不是类型错（int 类型没错，但值超范围）。所以别指望它像用户函数那样允许 ?? 或默认值兜底——它的校验发生在 C 层，非常早、非常硬。
立即学习“PHP免费学习笔记（深入）”；
