企业官网建设流程全解析

前言

日常业务代码里，「这段字符串里有没有某个内容」几乎是最常见的判断之一。很多人沿用很老的写法：strpos、strstr、substr_compare，再配上一堆!== false。这些函数本身没有问题，问题出在它们的返回值语义上——strpos()返回的是位置或者false，而位置0在布尔上下文里是假值；strstr()返回的是子串或者false，你只想判断存在性，却拿到了一大段字符串。

典型症状是这样的：本地用「abcdef」这种子串在中间的例子测得好好的，上线后遇到以关键字开头的字符串，判断突然失效，程序走进了错误分支；或者反过来，中文内容被字节函数切过之后得到半截乱码，后续匹配永远不成立，日志里连个报错都没有。还有一种更隐蔽的：strpos返回0被写进if里，代码「有时对有时错」，排查半小时才发现是0与false的区别。

PHP 8.0 引入了三个语义清晰的函数：str_contains()、str_starts_with()、str_ends_with()。它们只回答「是 / 不是」，让代码意图和返回值对得上。需要点明的是，这三个函数确实是PHP 8.0引入的，标题里的版号与官方事实一致，本文按 8.0 讲，同时在最后给出低版本可用的等价写法。

本文先讲清旧函数的坑在哪里，再给出按语义挑选 API 的对照办法，最后是一个可以直接保存成.php运行、自带断言自检的完整示例。

一、老函数的根因：返回值携带了「位置」而不是「结论」

strpos()的原型是strpos(string $haystack, string $needle, int $offset = 0): int|false。它返回首个匹配的字节偏移，未命中返回false。用布尔判断时，0和false会同时变成假值，这是所有strpos事故的根源。

strstr()的原型是strstr(string $haystack, string $needle, bool $before_needle = false): string|false，返回从匹配处开始的剩余字符串。用它做判断，等于把一个可能很长的字符串搬进内存，纯粹浪费。

substr_compare()可以用来做后缀比较，但参数是三个位置加一个长度，读代码的人得在脑子里算一遍下标。这些函数的共同点是：返回值类型不等于判断结论，必须由调用者二次解释，解释错了就出 bug。

<?php // 反例：三种"看起来对"的写法 $s = 'php8.0'; var_dump((bool) strpos($s, 'php')); // false —— 明明匹配了！ var_dump(strstr($s, 'php')); // string(5) "php8.0" —— 拿到整串，判断要再加工 var_dump(substr($s, -3) === '8.0'); // true，但下标 -3 是硬编码的魔法数

二、PHP 8.0 三个新函数：返回值就是结论

三个函数都是大小写敏感的字节级比较，内部就是一次线性扫描，不会额外复制字符串。返回值直接是bool，所以if (str_contains(...))就是最终结论，不存在0与false的歧义。

需要注意，PHP 8.0 并没有同时提供「不区分大小写」的版本，不存在str_icontains这类函数。不区分大小写的场景要回到stripos、strncasecmp或者多字节函数。

<?php $ua = 'Mozilla/5.0 (Windows NT 10.0)'; if (str_starts_with($ua, 'Mozilla/')) { echo "浏览器 UA\n"; } if (str_contains($ua, 'Windows')) { echo "Windows 平台\n"; }

三、按语义挑 API，才是「更精准」

「精准」分四层：位置层（命中在哪）、结论层（有没有）、结构层（是不是一个完整词、是不是纯数字）、编码层（按字节还是按字符）。逐层挑对函数，代码自然准。

str_contains传入的 needle 为空字符串时返回true，str_starts_with和str_ends_with同样如此。这是因为「空串是所有字符串的子串」在数学上成立，但在业务里几乎一定是参数没准备好。所以在接收外部输入时，先挡空值是个好习惯。

四、完整可运行示例

下面这个脚本需要PHP 8.0 或更高。它把常见的判断场景都跑一遍，并用自定义的断言函数在失败时立刻退出，可以直接保存为check.php后执行php check.php看到输出。

<?php declare(strict_types=1); // 简易断言：失败即抛出，便于直接观察结果 function check(bool $ok, string $label): void { echo ($ok ? '[OK] ' : '[FAIL] ') . $label . "\n"; if (!$ok) { throw new RuntimeException('断言失败: ' . $label); } } $logLine = 'GET /api/user?id=42 200'; // 1. 结论层：直接判断包含关系 check(str_contains($logLine, '/api/user'), '包含 /api/user'); check(!str_contains($logLine, '/api/order'), '不包含 /api/order'); // 2. 前缀 / 后缀：老写法要靠 substr 猜长度，这里直接表达 check(str_starts_with($logLine, 'GET '), '以 GET 开头'); check(str_ends_with($logLine, '200'), '以 200 结尾'); check(!str_ends_with($logLine, '404'), '不以 404 结尾'); // 3. 空针的行为：三种函数都返回 true，业务里通常要主动拦截 check(str_contains($logLine, '') === true, '空针返回 true（需要自己挡）'); check(str_starts_with('', '') === true, '双空串也为 true'); // 4. 针比原串长：不会报错，直接 false check(str_ends_with('ab', 'abcdef') === false, '针过长返回 false'); // 5. 位置层：必须与 false 全等比较 $pos = strpos($logLine, '43'); check($pos === false, '未命中时 strpos 返回 false'); check(strpos($logLine, 'GET') === 0, '开头命中返回 0'); // 6. 不区分大小写：8.0 没有 str_icontains，用 stripos check(stripos($logLine, 'get ') === 0, 'stripos 忽略大小写命中开头'); // 7. 多字节按字符定位 $title = 'PHP 中文标题'; $charPos = mb_strpos($title, '中', 0, 'UTF-8'); $bytePos = strpos($title, '中'); check($charPos === 4, 'mb_strpos 按字符计数'); check($bytePos !== $charPos, 'strpos 按字节计数，结果不同'); // 8. 结构层：整串必须是纯数字 $id = '0042'; check(ctype_digit($id), '整串为数字'); check(!ctype_digit('42a'), '含字母不算纯数字'); // 9. 结构层：词边界匹配，避免 order 命中 order_detail check( preg_match('/\border\b/u', 'select * from order_detail') === 0, '词边界让 order 不命中 order_detail' ); check( preg_match('/\border\b/u', 'select * from `order`') === 1, '词边界命中独立单词 order' ); echo "全部检查通过\n";

五、低版本环境的等价写法

如果项目暂时升不到 8.0，可以定义一个兜底实现，代码里照样用新函数名，升级时删掉这段即可：

<?php if (!function_exists('str_contains')) { function str_contains(string $haystack, string $needle): bool { return $needle === '' || strpos($haystack, $needle) !== false; } } if (!function_exists('str_starts_with')) { function str_starts_with(string $haystack, string $needle): bool { return strncmp($haystack, $needle, strlen($needle)) === 0; } } if (!function_exists('str_ends_with')) { function str_ends_with(string $haystack, string $needle): bool { return $needle === '' || substr($haystack, -strlen($needle)) === $needle; } }

注意str_starts_with的兜底里用strncmp而不是substr：当 needle 比 haystack 长时，substr会返回false，而false === $needle恰好也是假，结果虽然对，但多绕了一圈。strncmp的语义更直接。

常见坑点

1. 
   
2. ❌if (strpos($haystack, $needle))✅if (strpos($haystack, $needle) !== false)
3. 
   
   

命中位置为 0 时前者判为假，这是历史上出现频率最高的字符串 bug。

1. 
   
2. ❌if (str_contains($s, $needle))直接用在用户输入上 ✅ 先判$needle !== ''
3. 
   
   

空针永远返回 true。搜索词来自表单且用户没填时，逻辑会静默地「匹配一切」。

1. 
   
2. ❌strtolower($a) === strtolower($b)处理中文或带重音的文本 ✅mb_strtolower($a, 'UTF-8')
3. 
   
   

字节级转换会破坏多字节字符，产生乱码后比较必然不等。

1. 
   
2. ❌ 用preg_match('/^v1.0/', $ver)判断固定前缀 ✅str_starts_with($ver, 'v1.0')
3. 
   
   

正则里的.是通配符，v1x0、v1_0都会被匹配上，属于典型的「看起来更灵活其实更不精准」。

1. 
   
2. ❌if (str_starts_with($h, $n) === 1)✅if (str_starts_with($h, $n))
3. 
   
   

返回的是布尔值，用=== 1比较恒为假，而且开declare(strict_types=1)时也不会报错，非常难发现。

1. 
   
2. ❌ 先用strpos找位置、再用str_contains判存在 ✅ 一次strpos后全等比较
3. 
   
   

两次线性扫描，长文本上是白白的开销。

1. 
   
2. ❌str_ends_with($path, '.tar.gz')寄希望于它做后缀「列表」匹配 ✅ 逐个调用或先strtolower归一
3. 
   
   

它只比较一个固定串，不会把逗号分隔的多个后缀当选项。

1. 
   
2. ❌ 用strstr的返回值做判断 ✅str_contains
3. 
   
   

strstr会把匹配后的整段内容复制出来，只判存在时纯属浪费内存。

总结

字符串查找要「精准」，关键不是换一个更快的函数，而是让函数的返回值语义和你的判断意图对齐。PHP 8.0 的str_contains、str_starts_with、str_ends_with把「结论」直接作为返回值，消除了0与false的歧义；剩下的精准度问题——大小写、编码、词边界——则要靠stripos、mb_*系列和带修正符的正则分层解决。