WP_VALIDATE_BOOLEAN() │ WP 4.0.0

Функция WP_VALIDATE_BOOLEAN() преобразует значение указанной переменной в логическое значение: true (истина) или false (ложь).

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

Возвращаемое значение

Функция возвращает true или false, в зависимости от того, было ли значение валидным.

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

wp_validate_boolean( $value );

Параметры

• $value (mixed) (обязательный): Значение, которое необходимо проверить и преобразовать в логическое.

Примеры

Пример 1: Проверка различных значений

$var = wp_validate_boolean( true );           // bool(true)
$var = wp_validate_boolean( 'true' );         // bool(true)
$var = wp_validate_boolean( '11' );           // bool(true)
$var = wp_validate_boolean( 1 );              // bool(true)
$var = wp_validate_boolean( 'on' );           // bool(true)
$var = wp_validate_boolean( 'off' );          // bool(true)
$var = wp_validate_boolean( 'foo' );          // bool(true)
$var = wp_validate_boolean( new StdClass() ); // bool(true)
$var = wp_validate_boolean( [1] );            // bool(true)

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

Пример 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 );

Пример 3: Проверка значения на логическое

// Пример 1
$status = isset( $plugin_data['status'] ) ? wp_validate_boolean( $plugin_data['status'] ) : false;
$plugin_status = isset( $plugin_data['active'] ) ? wp_validate_boolean( $plugin_data['active'] ) : false;

// Пример 2
$is = true === wp_validate_boolean( $request->get_param( 'fetch_field_data' ) );

Изменения

Эта функция была введена в версии 4.0.0.

Код функции

function wp_validate_boolean( $value ) {
    if ( is_bool( $value ) ) {
        return $value;
    }

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

    return (bool) $value;
}

Связанные функции

Функция wp_validate_boolean() может взаимодействовать с другими функциями проверки в WordPress:

• array_is_list()
• is_admin_bar_showing()
• is_blog_installed()
• is_countable()
• is_email()
• is_iterable()
• is_php_version_compatible()
• is_serialized()
• is_serialized_string()
• is_wp_error()
• is_wp_version_compatible()
• seems_utf8()
• wp_doing_ajax()
• wp_is_https_supported()
• wp_is_json_request()
• wp_is_numeric_array()
• wp_is_using_https()

Эти функции могут помочь вам в различных сценариях обработки данных и проверок в вашем проекте на WordPress.