str_contains()自PHP 8.0起可用，要求两参数均为字符串，否则报错；低于8.0需用strpos()!==false；注意空字符串返回true、区分大小写、不自动类型转换及实际运行环境版本校验。
直接用 str_contains($haystack, $needle) 就行，但前提是 PHP 版本 ≥ 8.0，且两个参数都必须是字符串类型；否则会报错或触发警告。
确认 PHP 版本是否支持 str_contains
这个函数不是 PHP 8.4 新增的，它从 PHP 8.0.0 就已存在。很多人在本地开发环境看到 “PHP 8.4” 就默认能用，结果部署到服务器失败——因为 Apache 或 Nginx 背后的 PHP CLI 或 FPM 实际版本可能是 7.4 或 8.0-（未启用该函数）。
- 运行
php -v查 CLI 版本 - 在 Web 环境中调用
phpinfo()看实际运行版本 - 若版本低于 8.0，
str_contains会直接报Fatal error: Uncaught Error: Call to undefined function str_contains() - 此时必须改用
strpos($haystack, $needle) !== false（注意是!== false，不是!= false）
str_contains 的参数和边界行为
它只接受两个 string 类型参数，不自动类型转换。传非字符串会抛 TypeError，空字符串 '' 是合法的 needle，且恒为 true。
-
$haystack和$needle都会被强制要求是 string；传null、int、array直接报错 -
str_contains('abc', '')→true（空串被视作“总存在”） -
str_contains('TEST', 't')→false（严格区分大小写） - 支持命名参数：
str_contains(haystack: $s, needle: '.')，顺序可换，但无实质优势，仅提升可读性
处理不可信输入：比如来自 $_GET 或 $_FILES 的文件名
用户传来的文件名可能为空、为 null、或根本不是字符串，直接调用 str_contains 很容易出 warning 或 fatal error。
立即学习“PHP免费学习笔记（深入）”；
- 最简容错写法：
is_string($filename) ? str_contains($filename, '.') : false - 别用
str_contains((string) $filename, '.')—— 强转数组会变成"Array"，造成逻辑错误 - 如果要判断扩展名是否存在（即最后一个点号后有内容），
str_contains不够用，得配合pathinfo($filename, PATHINFO_EXTENSION)或正则 - 特别注意：
str_contains($filename, '.')对"my.file.name"和"."都返回 true，但后者通常不是你想要的“含有效扩展名”
替代方案选型：什么时候不该用 str_contains
它快、简洁、语义清晰，但不是万能的。遇到以下情况，换别的方法更稳妥：
- 需要忽略大小写 → 改用
stripos($haystack, $needle) !== false - 要匹配多个关键词之一 → 自定义函数
str_contains_any($haystack, ['jpg', 'png', 'gif'])，但需确保$needles全是字符串 - 要验证是否“以某串结尾”（如判断 .php 结尾）→ 用
str_ends_with($filename, '.php')（PHP 8.1+），比str_contains更准确 - 需对用户输入做模糊/正则匹配 → 回归
preg_match，但注意转义preg_quote($needle, '/')
真正容易被忽略的是：str_contains 不处理路径语义，也不关心点号是不是分隔符——它只是纯字符串扫描。判断文件扩展名时，光看有没有点号远远不够；而检查 URL 域名片段时，又得防住 example.com.evil.com 这类子域名误判。这些都不是函数本身的问题，而是用的人没想清场景。
