PHPのFILTER_VALIDATE_BOOLEAN定数とは？使い方と戻り値をわかりやすく解説

PHPには、外部からの入力値を安全に検証するためのフィルター関数が多数用意されています。その中でもFILTER_VALIDATE_BOOLEANは、渡された値をブール値（真偽値）として評価するための定数です。filter_var()関数と組み合わせて使用することで、文字列が「真」を表す値なのか「偽」を表す値なのかを簡単に判定できます。

基本的な使い方

FILTER_VALIDATE_BOOLEANは、filter_var()関数の第2引数に指定して使用します。

<?php
    $var = "on";
    var_dump(filter_var($var, FILTER_VALIDATE_BOOLEAN));
?>

戻り値の一覧

FILTER_VALIDATE_BOOLEANは、入力された値に応じて次のような結果を返します。

• TRUEを返す値： "1"、"true"、"on"、"yes"
• FALSEを返す値： "0"、"false"、"off"、"no"
• それ以外の値： NULLを返します

このように、チェックボックスのオン／オフや「はい／いいえ」形式の入力値などを判定する際に特に便利です。

例1： "on" を渡した場合

まずは、真を表す値 "on" を検証してみましょう。

<?php
    $var = "on";
    var_dump(filter_var($var, FILTER_VALIDATE_BOOLEAN));
?>

実行結果は次のとおりです。

bool(true)

例2： "off" を渡した場合

続いて、偽を表す値 "off" を検証してみます。

<?php
    $var = "off";
    var_dump(filter_var($var, FILTER_VALIDATE_BOOLEAN));
?>

実行結果は以下のようになります。

bool(false)

例3： 該当しない値を渡した場合

リストに含まれない値を渡すと、NULLが返されます。

<?php
    $var = "maybe";
    var_dump(filter_var($var, FILTER_VALIDATE_BOOLEAN));
?>

NULL

まとめ

FILTER_VALIDATE_BOOLEANを使えば、フォーム入力や設定値などの真偽判定をシンプルかつ安全に行えます。「1 / true / on / yes」はTRUE、「0 / false / off / no」はFALSE、それ以外はNULLという挙動を覚えておくと、条件分岐やバリデーション処理の実装がスムーズになります。