PHP str_contains()：判断字符串是否包含某段文本

如果 $needle 出现在 $haystack 中的任意位置，str_contains($haystack, $needle) 返回 true，否则返回 false。它是 PHP 8.0 新增的函数，区分大小写。

<?php
$sentence = 'The quick brown fox';

var_dump(str_contains($sentence, 'quick'));   // true
var_dump(str_contains($sentence, 'Quick'));   // false: case-sensitive
var_dump(str_contains($sentence, 'dog'));     // false

if (str_contains($sentence, 'fox')) {
    echo "Found a fox\n";
}

和 strpos() 不同，它返回真正的布尔值，所以不存在“在位置 0 找到却看起来像 false”的陷阱。

语法

str_contains(string $haystack, string $needle): bool
str_starts_with(string $haystack, string $needle): bool
str_ends_with(string $haystack, string $needle): bool

这三个函数都是 PHP 8.0 新增的，按字节比较，所以不需要 mb_ 版本也能正确处理日文、中文等 UTF-8 文本。

用 str_starts_with 和 str_ends_with 检查开头或结尾

<?php
$url = 'https://example.com/report.pdf';

var_dump(str_starts_with($url, 'https://'));   // true
var_dump(str_ends_with($url, '.pdf'));         // true
var_dump(str_ends_with($url, '.PDF'));         // false

$name = '株式会社コディ';
var_dump(str_starts_with($name, '株式会社'));   // true

不区分大小写的包含判断

PHP 没有 str_icontains()。先把两个字符串都转成小写。mb_strtolower() 还能转换 ASCII 以外的字母，比如 É 或西里尔字母，而 strtolower() 不会处理它们。

<?php
function containsIgnoreCase(string $haystack, string $needle): bool
{
    return str_contains(mb_strtolower($haystack), mb_strtolower($needle));
}

var_dump(containsIgnoreCase('Learning PHP', 'php'));       // true
var_dump(containsIgnoreCase('ÉCOLE DE CODE', 'école'));    // true

// The same check with stripos (ASCII letters only)
var_dump(stripos('Learning PHP', 'php') !== false);        // true

空的查找内容返回 true

空字符串在任何字符串里都能找到，包括空字符串本身。如果查找内容来自用户留空的搜索框，这一点就很重要。

<?php
var_dump(str_contains('abc', ''));    // true
var_dump(str_contains('', ''));       // true

$search = '';   // a blank search field
$title = 'PHP str_contains';
$matches = $search !== '' && str_contains($title, $search);
var_dump($matches);

判断字符串是否包含多个词中的任意一个或全部

str_contains() 只接收一个查找内容。遍历一个数组：判断“任意一个”时，一旦匹配就返回；判断“全部”时，一旦不匹配就返回。

<?php
function containsAny(string $haystack, array $needles): bool
{
    foreach ($needles as $needle) {
        if (str_contains($haystack, $needle)) {
            return true;
        }
    }
    return false;
}

function containsAll(string $haystack, array $needles): bool
{
    foreach ($needles as $needle) {
        if (!str_contains($haystack, $needle)) {
            return false;
        }
    }
    return true;
}

$comment = 'Buy cheap watches now';

var_dump(containsAny($comment, ['cheap', 'free', 'winner']));   // true
var_dump(containsAll($comment, ['cheap', 'free']));             // false

如果要检查某个值是不是数组的元素之一，而不是字符串的子串，用 in_array()。

PHP 8 之前：strpos !== false

需要在 PHP 7 上运行的代码会用 strpos() 加严格比较。它的结果和 str_contains() 相同，只有空的查找内容例外：PHP 7 的 strpos() 会打印 Warning: strpos(): Empty needle 并返回 false。

<?php
$haystack = 'php is fun';

var_dump(str_contains($haystack, 'php'));       // PHP 8
var_dump(strpos($haystack, 'php') !== false);   // PHP 7 and later

// The bug to avoid: position 0 is falsy
var_dump((bool) strpos($haystack, 'php'));

最后一行打印 bool(false)，尽管文本明明在里面，因为 php 位于位置 0。把这类判断换成 str_contains() 是升级到 PHP 8 最容易的改进之一。