Описание функции str_contains()
Функция str_contains() проверяет, содержит ли строка указанную подстроку. Эта функция полезна для выполнения простых проверок на наличие текста в строках, что может быть необходимо в различных сценариях, таких как валидация данных, фильтрация контента и т.д.
Она является частью стандартных функций PHP, доступной в WordPress начиная с версии 5.9
Параметры
$haystack
Тип: string
Обязательный: Да
Описание: Строка, в которой будет производиться поиск
Возможные значения:
$needle
Тип: string
Обязательный: Да
Описание: Подстрока, которую нужно найти в haystack
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если подстрока найдена, иначе false
Возможные значения:
• true — если подстрока найдена
• false — если подстрока не найдена
Примеры использования
Проверка наличия подстроки ‘World’ в строке ‘Hello, World!’
$result = str_contains('Hello, World!', 'World');
// $result будет true
Простой пример использования функции
Проверка наличия подстроки ‘мир’ в строке ‘Привет, мир!’
$result = str_contains('Привет, мир!', 'мир');
// $result будет true
Функция поддерживает любые символы
Проверка отсутствия подстроки ‘не найдена’ в строке ‘Тестовая строка’
$result = str_contains('Тестовая строка', 'не найдена');
// $result будет false
Функция корректно возвращает false
Проверка наличия слова ‘важный’ в содержимом записи
$content = get_the_content();
if (str_contains($content, 'важный')) {
// Выполняем действия, если контент содержит 'важный'
}
Полезно для условного отображения контента
Проверка наличия слова ‘WordPress’ в заголовке поста
$search_term = 'WordPress';
if (str_contains($post_title, $search_term)) {
echo 'Заголовок содержит ' . $search_term;
}
Часто используется для вывода сообщений
Безопасность
Валидация входных данных: Необходимо убедиться, что параметры — строки
Санитизация: Параметры автоматически очищаются при передаче
Рекомендации: При использовании результатов функции, учитывайте возможность false
— Связанные функции
Возвращает позицию первого вхождения подстроки в строку
Проверяет, начинается ли строка с указанной подстроки
Проверяет, заканчивается ли строка на указанную подстроку
— Примечания
– Ограничения
Функция чувствительна к регистру
– Частые проблемы
- Неверный результат при использовании неправильных типов данных
- Проблемы с кодировкой при работе с многобайтовыми строками
