PHP strpos()：查找子串出现的位置

strpos($haystack, $needle) 返回 $needle 在 $haystack 中第一次出现的位置（从 0 开始计算），如果不存在则返回 false。务必用 !== false 检查结果，因为匹配在开头时返回 0。

<?php
$text = 'apple, banana, cherry';

var_dump(strpos($text, 'banana'));   // found at position 7
var_dump(strpos($text, 'apple'));    // found at position 0
var_dump(strpos($text, 'grape'));    // not found

if (strpos($text, 'apple') !== false) {
    echo "Found apple\n";
}

如果在 PHP 8 中只需要“是”或“否”的答案，str_contains() 更清楚。位置本身有用时再用 strpos()。

语法

strpos(string $haystack, string $needle, int $offset = 0): int|false

查找区分大小写。$offset 指定从哪里开始查找；负数偏移量从字符串末尾开始计算。

!== false 陷阱

在宽松比较（==）下，0 和 false 相等。所以只要判断不是严格比较，位置 0 的匹配就会被当成“没找到”。

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

// Wrong: position 0 is falsy, so this says "no"
if (strpos($url, 'https')) {
    echo "wrong check: has https\n";
} else {
    echo "wrong check: no https\n";
}

// Right: compare strictly with false
if (strpos($url, 'https') !== false) {
    echo "right check: has https\n";
}

同样的规则也适用于 stripos()、strrpos() 和 array_search()，它们在真正找到匹配时都可能返回 0。

用 stripos 不区分大小写地查找

stripos() 接收同样的参数，忽略 ASCII 字母的大小写。

<?php
$title = 'Learning PHP the Hard Way';

var_dump(strpos($title, 'php'));    // case-sensitive: not found
var_dump(stripos($title, 'php'));   // found at 9

用 strrpos 查找最后一处匹配

strrpos() 返回最后一处匹配的位置。获取文件扩展名或路径的最后一段时，通常就这么写。

<?php
$file = 'archive.backup.tar.gz';

$dot = strrpos($file, '.');
echo substr($file, $dot + 1), "\n";      // gz
echo substr($file, 0, $dot), "\n";       // archive.backup.tar

$path = '/var/www/html/index.php';
echo substr($path, strrpos($path, '/') + 1), "\n";

如果处理的是文件名，pathinfo($file, PATHINFO_EXTENSION) 可以直接帮你完成。在某个位置截断字符串的方法见 substr() 页面。

从指定偏移量开始查找

第三个参数用来跳过字符串的开头部分。负数偏移量表示从末尾往前数那么多个字符开始。

<?php
$s = 'one two one two';

var_dump(strpos($s, 'one'));        // 0
var_dump(strpos($s, 'one', 1));     // skip position 0: finds the second one
var_dump(strpos($s, 'two', -3));    // search only the last 3 characters

查找所有出现位置

strpos() 只找一处匹配。要找出全部，就在循环里把偏移量移到每次匹配之后：

<?php
$text = 'the cat sat on the mat with the hat';
$needle = 'the';

$positions = [];
$offset = 0;
while (($pos = strpos($text, $needle, $offset)) !== false) {
    $positions[] = $pos;
    $offset = $pos + strlen($needle);
}

print_r($positions);
echo count($positions), " matches\n";

只需要次数？substr_count($text, 'the') 更简短。按模式查找时，preg_match_all() 配合 PREG_OFFSET_CAPTURE 会返回每一处匹配及其位置。

中文和日文文本：字节位置与字符位置

strpos() 能正确找到多字节文本，但它返回的数字以字节为单位。在 UTF-8 中，假名和常用汉字各占 3 个字节，所以在全是汉字或假名的文本里，字节位置是字符位置的三倍；在混合文本里，两者的差距就没那么好算了。mb_strpos() 返回字符位置，这正是 mb_substr() 需要的。

<?php
$s = '東京都渋谷区';

var_dump(strpos($s, '渋谷'));      // byte position
var_dump(mb_strpos($s, '渋谷'));   // character position

echo mb_substr($s, mb_strpos($s, '渋谷')), "\n";

把两者混着用是一个经典 bug：把 strpos() 的结果传给 mb_substr()，起点会偏后太多。strpos 配 substr，mb_strpos 配 mb_substr。