随着互联网的发展，字符串处理在编程中成为了一项常见的任务。针对字符串匹配问题，php8引入了新的函数str_contains()，该函数可以快速地返回一个字符串中是否包含指定的字串。对于需要频繁进行字符串匹配的开发人员来说，这款函数将是一个非常有用的工具。
一、str_contains()函数的基本用法
str_contains()函数用于判断一个字符串中是否包含指定的字串，其语法如下：
bool str_contains( string $haystack , string $needle )
其中，$haystack表示原始字符串，$needle表示要检测的字串。如果原始字符串中包含指定的字串，则该函数返回true，否则返回false。
下面是一些示例：
示例1：
立即学习“PHP免费学习笔记（深入）”；
$str1 = "Hello World!";
if (str_contains($str1, "World")) {
echo "The string contains the word 'World'";
} else {
echo "The string does not contain the word 'World'";
}
该示例中的$haystack为"Hello World!"，$needle为"World"。由于$haystack中包含$needle，因此该函数将返回true，并打印出字符串"The string contains the word 'World'"。
示例2：
$str2 = "Hello World!";
if (str_contains($str2, "Universe")) {
echo "The string contains the word 'Universe'";
} else {
echo "The string does not contain the word 'Universe'";
}
该示例中的$haystack为"Hello World!"，$needle为"Universe"。由于$haystack中不包含$needle，因此该函数将返回false，并打印出字符串"The string does not contain the word 'Universe'"。
二、str_contains()函数的优势
在之前，PHP已经有了函数strstr()和strpos()，用于在字符串中查找子串并返回其位置。然而，str_contains()函数相比之下有以下几个优势：
- 更简洁的代码
使用str_contains()函数，只需要一行代码就可以完成字符串匹配的任务。例如：
if (str_contains($str, "needle")) {
// Code to execute if the string contains "needle"
}
相比而言，使用strstr()或strpos()函数时，需要在返回值上进行if条件判断，然后才能确定是否匹配成功。
- 更直观的代码
str_contains()函数的命名非常直观，使用起来更加符合编程人员的自然习惯。与其他函数相比，使用这个函数开发人员不需要阅读函数文档找出合适的参数值，直接使用识别度更高。 - 更高的性能
经测试，str_contains()函数的性能可与之前的字符串匹配函数相比，甚至更好。在大数据量的情况下，str_contains()函数能够提供更快的匹配速度，因为其内部实现采用了更高效的算法。
三、如何迁移项目以使用str_contains()函数
如果你希望在项目中使用str_contains()函数，需要确保PHP版本已经升级到8.0或以上。一旦升级完毕，你需要对项目中使用strstr()或strpos()函数的地点进行修改。
首先，你需要根据项目的实际情况选择需要更新的地点。如果需要在大量的代码中使用该函数，那么可以使用搜索和替换功能，将旧的函数调用修改为新的函数调用。
例如，将$strstr()函数的调用：
if (strstr($haystack, $needle)) {
// ...
}
修改为$str_contains()函数的调用：
if (str_contains($haystack, $needle)) {
// ...
}
这样，你的项目就能够开始使用str_contains()函数了。
四、结论
str_contains()函数是PHP8中引入的字符串匹配函数之一，性能更强，使用更加简洁明了。如果你目前还在使用strstr()或strpos()函数，在有需要的情况下，建议积极地迁移为str_contains()函数。
