PHP str_contains：手动实现PHP 8字符串函数的兼容层-php教程-PHP中文网

php 7 项目中需手动添加 str_contains() 兼容函数：在入口文件前置声明，用 function_exists 检查后定义，核心逻辑为 '' === $needle || false !== strpos($haystack, $needle)，并严格声明 string 类型参数。

php str_contains：手动实现php 8字符串函数的兼容层

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 就崩了。

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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

所以兼容层必须带完整类型声明，并做输入校验（虽然 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 检查该文件语法，它会在所有请求中无条件执行，出错会导致整个应用崩溃