wp_validate_boolean() WP 4.0.0

Проверяет переданный тип переменной, убеждается что он логический. Переводит его в логический и возвращает обратно.

Альтернатива конструкции: filter_var( $var, FILTER_VALIDATE_BOOLEAN ).

Хуков нет.

Возвращает

true/false.

Использование

wp_validate_boolean( $var );

$var(смешанный) (обязательный): Переменная которую нужно проверить, является ли она логической.

Примеры

#1 Демонстрация работы

$var = wp_validate_boolean( true );    // bool(true)

$var = wp_validate_boolean( 'false' ); // bool(false)

$var = wp_validate_boolean( 'foo' );   // bool(true)

$var = wp_validate_boolean( '0' );     // bool(false)

$var = wp_validate_boolean( '11' );    // bool(true)

$var = wp_validate_boolean( null );    // bool(false)

$var = wp_validate_boolean( 1 );       // bool(true)

$var = wp_validate_boolean( 'on' );    // bool(true)
$var = wp_validate_boolean( 'off' );   // bool(true)

#2 Убедимся что мы передаем логические данные

Иногда нужно точно знать, что передаются логические данные, например когда мы работает с JSON. Пр. PHP понимает '0', как false, но JSON понимает иначе, и в этих случаях нужно убедиться что предаются именно логические данные. Допустим мы передаем настройки:

$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 );

Список изменений

С версии 4.0.0

Введена.

Код `wp_validate_boolean() wp validate boolean` ^{WP 5.6.2}

wp-includes/functions.php

<?php
function wp_validate_boolean( $var ) {
	if ( is_bool( $var ) ) {
		return $var;
	}

	if ( is_string( $var ) && 'false' === strtolower( $var ) ) {
		return false;
	}

	return (bool) $var;
}