Функция wp_validate_boolean() в WordPress используется для проверки и преобразования значений в логические (boolean) типы. Это полезно для ситуаций, когда вам нужно гарантировать, что переданные данные соответствуют ожидаемому формату логических значений.
wp_validate_boolean( mixed $value ): bool
Функция служит альтернативой для filter_var( $value, FILTER_VALIDATE_BOOLEAN ). Она принимает произвольное значение и преобразует его в логическое значение true или false, в зависимости от его содержания.
Параметры
- $value (mixed) — переменная, которую нужно проверить на логическое значение. Это обязательный параметр.
Возвращаемое значение
- bool — возвращает
true, если значение можно интерпретировать как логическоеtrue, иfalseв противном случае.
Пример 1: Основная демонстрация работы функции
В этом примере мы проверяем различные значения и получаем их логические эквиваленты:
var_dump(wp_validate_boolean(true)); // bool(true)
var_dump(wp_validate_boolean(false)); // bool(false)
var_dump(wp_validate_boolean('true')); // bool(true)
var_dump(wp_validate_boolean('false')); // bool(false)
var_dump(wp_validate_boolean('test')); // bool(true)
var_dump(wp_validate_boolean(123)); // bool(true)
var_dump(wp_validate_boolean(0)); // bool(false)
var_dump(wp_validate_boolean(null)); // bool(false)
var_dump(wp_validate_boolean([])); // bool(false)
var_dump(wp_validate_boolean(['test'])); // bool(true)
var_dump(wp_validate_boolean(new stdClass())); // bool(true)
Пример 2: Проверка логических данных перед передачей в JSON
Иногда важно удостовериться, что данные, передаваемые в JSON, имеют правильный логический тип. Например:
$atts = array(
'tracklist' => 'on',
'tracknumbers' => '0',
'images' => 'true',
'artists' => 'off',
);
$json_data = array(
'tracklist' => wp_validate_boolean( $atts['tracklist'] ),
'tracknumbers' => wp_validate_boolean( $atts['tracknumbers'] ),
'images' => wp_validate_boolean( $atts['images'] ),
'artists' => wp_validate_boolean( $atts['artists'] ),
);
echo json_encode($json_data);
В этом примере каждый элемент массива $atts проходит проверку на логическое значение, гарантируя, что данные будут корректно обработаны при кодировании в JSON.
Пример 3: Учитываем значения ‘on’ и ‘off’
Если нужно учитывать дополнительные значения, такие как ‘on’ и ‘off’, можно использовать следующую проверку:
$show = 'off';
$show = wp_validate_boolean($show) && ($show !== 'off');
if ($show) {
echo 'Показать';
} else {
echo 'Не показывать';
}
Заключение
Функция wp_validate_boolean() является полезным инструментом для обработки логических значений в WordPress. Она помогает избежать ошибок, связанных с неправильной интерпретацией данных, и обеспечивает надежную проверку перед использованием значений в различных контекстах, таких как работа с JSON или настройка параметров. Использование этой функции повышает надежность и безопасность кода.