本文旨在介绍如何使用 PHP 中的 `str_contains()` 函数来判断一个字符串（例如 URL）是否包含特定的关键词。我们将通过示例代码、注意事项和改进方案，帮助你掌握字符串查找的技巧，并编写出更健壮的 PHP 代码。
在 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 是否包含 "amazon.de" 或 "brickset.com" 关键词，并根据结果输出不同的信息。下面是一个示例代码：
<?php
function url_mapping_name(string $urlname): string {
if (str_contains($urlname, 'amazon.de')) {
return 'amazon';
} else if (str_contains($urlname, 'brickset.com')) {
return 'brickset';
} else {
return 'no URL';
}
}
// 示例用法
$url1 = 'https://www.amazon.de/some-product';
$url2 = 'https://www.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 地址），并返回一个字符串。
- str_contains() 函数使用： 使用 str_contains() 函数检查 $urlname 是否包含 "amazon.de"。如果包含，则返回字符串 "amazon"。
- else if 结构： 如果 $urlname 不包含 "amazon.de"，则使用 else if 结构检查是否包含 "brickset.com"。如果包含，则返回字符串 "brickset"。
- else 语句： 如果 $urlname 既不包含 "amazon.de" 也不包含 "brickset.com"，则返回字符串 "no URL"。
- 示例用法： 提供了三个示例 URL，并调用 url_mapping_name 函数来演示其用法，并将结果输出到控制台。
注意事项
-
大小写敏感： str_contains() 函数默认是大小写敏感的。如果需要进行大小写不敏感的匹配，可以使用 strtolower() 或 strtoupper() 函数将字符串转换为统一的大小写形式。
<?php $url = 'https://www.Amazon.de/some-product'; if (str_contains(strtolower($url), 'amazon.de')) { echo '包含 amazon.de (忽略大小写)'; } ?> -
PHP 版本要求： str_contains() 函数是 PHP 8.0 引入的。如果你的 PHP 版本低于 8.0，你需要使用其他方法，例如 strpos() 函数。
<?php $url = 'https://www.amazon.de/some-product'; if (strpos($url, 'amazon.de') !== false) { echo '包含 amazon.de'; } ?>注意： strpos() 函数返回子字符串第一次出现的位置。如果未找到子字符串，则返回 false。因此，需要使用 !== false 来判断是否包含子字符串。
使用 else if 结构： 在多个条件判断时，建议使用 else if 结构，以避免不必要的判断和可能的错误。在最初的代码中，使用了两个独立的 if 语句，导致在包含 "amazon.de" 的情况下，仍然会执行 "brickset" 的判断，并可能输出错误的结果。
返回值类型： 确保函数返回正确的数据类型。在示例代码中，我们希望函数返回一个字符串，因此使用 return 语句返回字符串。
总结
str_contains() 函数是 PHP 中一个非常有用的字符串处理函数，可以方便地判断一个字符串是否包含另一个字符串。通过本文的介绍和示例代码，你应该已经掌握了如何使用这个函数，并了解了一些注意事项。在实际开发中，可以根据具体需求灵活运用 str_contains() 函数，编写出更高效、更健壮的 PHP 代码。
