本文旨在讲解如何使用 PHP 函数 str_contains() 来判断一个字符串（例如 URL）是否包含特定的子字符串，并根据判断结果返回相应的值。我们将通过示例代码演示如何正确使用该函数，并讨论常见的错误以及如何避免。
在 PHP 中，判断一个字符串是否包含另一个字符串是一个常见的任务。str_contains() 函数提供了一种简洁有效的方式来实现这一功能。
str_contains() 函数简介
str_contains() 函数是 PHP 8.0 引入的，用于检查一个字符串是否包含另一个字符串。它的基本语法如下：
str_contains(string $haystack, string $needle): bool
- $haystack: 要搜索的字符串。
- $needle: 要查找的子字符串。
该函数返回一个布尔值：如果 $haystack 包含 $needle，则返回 true，否则返回 false。
立即学习“PHP免费学习笔记（深入）”；
示例：检查 URL 是否包含特定文本
假设我们需要编写一个函数，根据 URL 中是否包含特定的关键词来返回不同的字符串。例如，如果 URL 包含 "amazon.de"，则返回 "amazon"；如果包含 "brickset"，则返回 "brickset"；否则返回 "no URL"。
以下是使用 str_contains() 函数实现该功能的示例代码：
function url_mapping_name(string $urlname): string {
if (str_contains($urlname, 'amazon.de')) {
return 'amazon';
} elseif (str_contains($urlname, 'brickset')) {
return 'brickset';
} else {
return 'no URL';
}
}
// 示例用法
$url1 = 'https://www.amazon.de/some-product';
$url2 = 'https://brickset.com/article/12345';
$url3 = 'https://www.example.com';
echo url_mapping_name($url1) . PHP_EOL; // 输出：amazon
echo url_mapping_name($url2) . PHP_EOL; // 输出：brickset
echo url_mapping_name($url3) . PHP_EOL; // 输出：no URL代码解释：
- url_mapping_name() 函数接收一个字符串参数 $urlname，表示要检查的 URL。
- 使用 if...elseif...else 结构，依次检查 $urlname 是否包含 "amazon.de" 和 "brickset"。
- 如果包含，则返回相应的字符串；否则，返回 "no URL"。
- 示例用法展示了如何调用该函数，并打印返回结果。
常见错误及注意事项
使用 echo 代替 return：
初学者容易犯的错误是使用 echo 来输出结果，而不是使用 return 来返回结果。echo 只是将字符串输出到屏幕，而 return 才能将值传递给调用函数的地方。正确的做法是使用 return。多个 if 语句代替 elseif：
如果使用多个独立的 if 语句，即使第一个条件满足，后续的 if 语句仍然会被执行。这可能导致返回错误的结果。应该使用 elseif 来确保只有一个条件被执行。-
PHP 版本兼容性：
str_contains() 函数是 PHP 8.0 引入的。如果你的 PHP 版本低于 8.0，则无法使用该函数。可以使用 strpos() 函数来替代。strpos() 函数返回子字符串在字符串中首次出现的位置。如果未找到子字符串，则返回 false。以下是使用 strpos() 函数实现相同功能的示例代码：
function url_mapping_name_legacy(string $urlname): string { if (strpos($urlname, 'amazon.de') !== false) { return 'amazon'; } elseif (strpos($urlname, 'brickset') !== false) { return 'brickset'; } else { return 'no URL'; } }注意：
在使用 strpos() 函数时，需要使用 !== false 来判断子字符串是否存在，因为 strpos() 函数可能返回 0，表示子字符串在字符串的起始位置。0 在弱类型比较中会被认为是 false，因此需要使用严格比较运算符 !==。
总结
str_contains() 函数是 PHP 中一个非常方便的字符串处理函数，可以用于快速判断一个字符串是否包含另一个字符串。在使用该函数时，需要注意 PHP 版本兼容性，以及使用 return 返回结果。对于 PHP 8.0 之前的版本，可以使用 strpos() 函数来替代，但需要注意使用 !== false 进行判断。通过掌握这些知识，你可以更加高效地处理字符串相关的任务。
