PHP 7 项目中需手动添加 str_contains() 兼容函数：在入口文件前置声明，用 function_exists 检查后定义，核心逻辑为 '' === $needle || false !== strpos($haystack, $needle)，并严格声明 string 类型参数。
PHP 7 项目里想用 str_contains() 怎么办？
直接调用会报 Call to undefined function str_contains() —— 这函数是 PHP 8.0 才加的，7.x 完全没有。别急着升级 PHP 或改逻辑，加个兼容声明就能用。
最稳妥的做法是在项目启动前（比如 bootstrap.php 或 functions.php）检查函数是否存在，不存在就手动定义：
if (!function_exists('str_contains')) {
function str_contains(string $haystack, string $needle): bool {
return '' === $needle || false !== strpos($haystack, $needle);
}
}
注意两点：一是必须用 string 类型声明（PHP 7.0+ 支持），二是空字符串判断要显式写成 '' === $needle，因为 strpos('', '') 返回 0，而 0 在松散比较下是 false，会导致误判。
str_contains() 和 strpos() 的行为差异在哪？
核心区别在对空字符串的处理：str_contains('abc', '') 应该返回 true（PHP 8 规范），但直接写 strpos('abc', '') !== false 会返回 false，因为 strpos() 对空搜索串返回 0，而 0 !== false 是 true —— 看似没问题，但反过来写 === false 就崩了。
立即学习“PHP免费学习笔记（深入）”；
-
strpos($haystack, $needle) !== false：对$needle = ''返回0 !== false → true，表面正确，但语义混乱，且依赖隐式转换 -
'' === $needle || false !== strpos(...)：显式覆盖边界情况，和 PHP 8 行为完全一致 - 别用
mb_strpos()替代 ——str_contains()是字节级匹配，不是多字节安全的；如果真需要多字节支持，应该用mb_strpos() !== false单独封装
为什么不能直接 alias strpos()？
因为 str_contains() 要求参数必须是 string，而 strpos() 允许 null 或数字（会转成字符串）。如果偷懒写成 function str_contains($a, $b) { return false !== strpos($a, $b); }，PHP 7.4+ 启用严格模式时会触发类型警告，PHP 8 更会直接报 TypeError。
所以兼容层必须带完整类型声明，并做输入校验（虽然 PHP 7 不强制，但为了和 PHP 8 行为对齐，建议保留）：
if (!function_exists('str_contains')) {
function str_contains(string $haystack, string $needle): bool {
// PHP 8 还会 throw TypeError for null/float/etc., 但 PHP 7 不拦截，这里不主动 throw，靠类型声明兜底
return '' === $needle || false !== strpos($haystack, $needle);
}
}
实际项目中，如果你开了 declare(strict_types=1)，这个声明就能拦住非字符串传参，比运行时判断更轻量。
Composer 自动加载兼容函数的最佳实践
把兼容函数丢进 src/Support/Php8Compat.php 并不行 —— 它得在任何业务代码执行前就被加载，否则类文件里先用了 str_contains() 就挂了。
- 在
composer.json的"autoload"→"files"里注册："src/Support/str_contains.php" - 文件名用函数名命名（如
str_contains.php），避免和其他函数混在一起，方便后续加str_starts_with()、str_ends_with() - 不要放进
psr-4命名空间里 —— 函数不是类，不需要自动加载机制，files是最直接可靠的方案 - 上线前用
php -l检查该文件语法，它会在所有请求中无条件执行，出错会导致整个应用崩溃
真正容易被忽略的是：有些框架（比如 Laravel）的测试环境可能用不同入口，或命令行跑的 Artisan 命令没走 Web 入口 —— 务必确认所有执行路径都加载了这个文件。
