本文旨在介绍如何使用 PHP 中的 `str_contains()` 函数来判断一个字符串（例如 URL）是否包含特定的子字符串。我们将通过示例代码、注意事项以及优化方案，帮助你掌握该函数的正确用法，并避免常见的错误。
在 PHP 中，判断一个字符串是否包含另一个字符串，可以使用 str_contains() 函数。该函数自 PHP 8.0 起可用，如果你的 PHP 版本低于 8.0，则需要使用 strpos() 函数来替代实现相同的功能。
str_contains() 函数的使用
str_contains() 函数接受两个参数：
- $haystack：要搜索的字符串（即被搜索的字符串）。
- $needle：要查找的子字符串。
函数返回一个布尔值：如果 $haystack 包含 $needle，则返回 true；否则，返回 false。
示例代码：
<?php
$url = "https://www.amazon.de/example";
if (str_contains($url, "amazon.de")) {
echo "URL 包含 amazon.de";
} else {
echo "URL 不包含 amazon.de";
}
?>这段代码会输出 "URL 包含 amazon.de"。
常见错误与解决方案
一个常见的错误是在使用 if 语句时，没有使用 else if 来避免不必要的判断。例如，以下代码：
<?php
function url_mapping_name( $urlname ) {
if (str_contains($urlname, 'amazon.de')) {
echo "amazon";
}
if (str_contains($urlname, 'brickset')) {
echo 'brickset';
} else {
echo 'no URL';
}
}
?>这段代码的问题在于，即使 $urlname 包含 "amazon.de"，也会继续判断是否包含 "brickset"，并可能输出 "no URL"，这与预期的行为不符。
正确的写法：
使用 else if 可以避免不必要的判断，提高代码效率：
<?php
function url_mapping_name( $urlname ) {
if (str_contains($urlname, 'amazon.de')) {
echo "amazon";
} else if (str_contains($urlname, 'brickset')) {
echo 'brickset';
} else {
echo 'no URL';
}
}
?>现在，如果 $urlname 包含 "amazon.de"，则只会输出 "amazon"，而不会继续判断是否包含 "brickset"。
使用 return 代替 echo
在函数中，通常更推荐使用 return 来返回值，而不是直接使用 echo 输出。这样做可以使函数更加灵活，方便在其他地方使用返回值。
示例代码：
<?php
function url_mapping_name( $urlname ) {
if (str_contains($urlname, 'amazon.de')) {
return "amazon";
} else if (str_contains($urlname, 'brickset')) {
return 'brickset';
} else {
return 'no URL';
}
}
$url = "https://www.amazon.de/example";
$result = url_mapping_name($url);
echo $result; // 输出 "amazon"
?>注意事项
- str_contains() 函数区分大小写。如果需要进行不区分大小写的判断，可以使用 stripos() 函数。
- 确保你的 PHP 版本大于等于 8.0，否则需要使用 strpos() 函数来替代实现相同的功能。
使用 strpos() 函数 (PHP zuojiankuohaophpcn 8.0)
如果你的 PHP 版本低于 8.0，可以使用 strpos() 函数来实现相同的功能。 strpos() 函数返回子字符串在字符串中首次出现的位置。如果未找到子字符串，则返回 false。
示例代码：
<?php
function url_mapping_name( $urlname ) {
if (strpos($urlname, 'amazon.de') !== false) {
return "amazon";
} else if (strpos($urlname, 'brickset') !== false) {
return 'brickset';
} else {
return 'no URL';
}
}
$url = "https://www.amazon.de/example";
$result = url_mapping_name($url);
echo $result;
?>注意： 使用 strpos() 函数时，需要使用严格相等运算符 !== 来判断返回值是否为 false。因为 strpos() 函数返回的位置索引从 0 开始，如果子字符串出现在字符串的开头，则 strpos() 函数返回 0，而 0 == false 在 PHP 中为真，所以需要使用 !== 来区分未找到子字符串的情况。
总结
str_contains() 函数是 PHP 中判断字符串是否包含特定子字符串的便捷工具。通过本文的介绍，你应该已经掌握了该函数的正确用法，并了解了如何避免常见的错误。 记住，选择合适的函数（str_contains() 或 strpos()）取决于你的 PHP 版本。 在编写代码时，请注意代码的逻辑结构，使用 else if 避免不必要的判断，并优先使用 return 来返回值，以提高代码的灵活性和可维护性。
