【PHP8.x】FILTER_VALIDATE_FLOAT定数の使い方

Copy
1<?php
2
3/**
4 * PHPのFILTER_VALIDATE_FLOAT定数を使用した浮動小数点数バリデーションのサンプルです。
5 *
6 * この関数は、filter_var関数とFILTER_VALIDATE_FLOAT定数を用いて、
7 * 与えられた値が有効な浮動小数点数であるかを検証する方法を示します。
8 * システムエンジニアを目指す初心者にも理解しやすいように、様々なデータ型での挙動を例示しています。
9 */
10function validateFloatExample(): void
11{
12    // 検証する様々な値のセット
13    $testValues = [
14        '123.45',     // 有効な浮動小数点数
15        '-98.76',     // 負の浮動小数点数も有効
16        '0.0',        // ゼロも有効
17        '123',        // 整数は浮動小数点数として有効と判断される (例: 123.0)
18        '1.2e3',      // 指数表記も有効 (例: 1200.0)
19        'abc',        // 無効な文字列
20        '123a',       // 数字の後に文字が続くため無効
21        '',           // 空文字列は無効
22        null,         // nullは無効
23        false         // booleanのfalseは無効
24    ];
25
26    echo "--- 浮動小数点数バリデーションの例 ---" . PHP_EOL . PHP_EOL;
27
28    foreach ($testValues as $value) {
29        // filter_var() 関数を使用し、FILTER_VALIDATE_FLOAT 定数で検証します。
30        // 検証が成功した場合、filter_varはフィルタリングされた値（多くの場合、元の値）を返します。
31        // 検証が失敗した場合、filter_varはブーリアンの false を返します。
32        $filteredResult = filter_var($value, FILTER_VALIDATE_FLOAT);
33
34        // 値の型を考慮して表示を調整
35        $displayValue = is_scalar($value) ? var_export($value, true) : '(' . gettype($value) . ')';
36
37        echo "元の値: " . $displayValue . PHP_EOL;
38
39        if ($filteredResult !== false) {
40            echo "結果: 有効な浮動小数点数です。 (フィルタリングされた値: " . var_export($filteredResult, true) . ")" . PHP_EOL;
41        } else {
42            echo "結果: 無効な浮動小数点数です。" . PHP_EOL;
43        }
44        echo PHP_EOL; // 各テストケースの後に改行を追加
45    }
46}
47
48// 関数を実行して、バリデーションの例を表示します。
49validateFloatExample();

PHP 8で提供されるFILTER_VALIDATE_FLOATは、与えられた値が有効な浮動小数点数であるかを検証するための定数です。この定数自体は引数を持たず、特定の整数値を返すことで、filter_var関数に浮動小数点数検証の指示を与えます。

主にfilter_var関数と組み合わせて使用します。filter_var関数の第1引数に検証したい値を、第2引数にFILTER_VALIDATE_FLOAT定数を指定することで、浮動小数点数として適切かどうかのチェックが行われます。

検証が成功した場合、filter_var関数はフィルタリングされた浮動小数点数を返します。例えば、文字列の"123.45"や"-98.76"、指数表記の"1.2e3"などは有効と判断され、浮動小数点数として返されます。また、整数の"123"のような値も、浮動小数点数として有効（123.0）と判断されます。

一方、検証が失敗した場合は、filter_var関数はブーリアンのfalseを返します。例えば、"abc"のような数字以外の文字を含む文字列や、"123a"のように数字の後に文字が続く場合、空文字列、null、falseなどの値は無効と判断され、falseが返されます。

この定数を利用することで、ユーザーからの入力値など、信頼できないデータを安全に処理するための基本的なバリデーションを簡単に実装できます。これにより、システムの信頼性とセキュリティを高めることができます。

Copy
1<?php
2
3/**
4 * FILTER_VALIDATE_FLOAT 定数を使用して、文字列が有効な浮動小数点数であるか検証する例を示します。
5 * この定数は filter_var() 関数などと組み合わせて使用され、入力値が浮動小数点数の形式に
6 * 沿っているかをチェックします。
7 *
8 * @return void
9 */
10function validateFloatExamples(): void
11{
12    echo "--- 浮動小数点数検証のデモンストレーション ---\n\n";
13
14    // 例1: 有効な浮動小数点数
15    $value1 = "123.45";
16    $result1 = filter_var($value1, FILTER_VALIDATE_FLOAT);
17    echo "値 '{$value1}' の検証:\n";
18    if ($result1 !== false) {
19        echo "  結果: 有効な浮動小数点数です。検証後の値: " . $result1 . " (型: " . gettype($result1) . ")\n";
20    } else {
21        echo "  結果: 無効な浮動小数点数です。\n";
22    }
23    echo "\n";
24
25    // 例2: 整数値 (浮動小数点数としても有効と判断されます)
26    $value2 = "987";
27    $result2 = filter_var($value2, FILTER_VALIDATE_FLOAT);
28    echo "値 '{$value2}' の検証:\n";
29    if ($result2 !== false) {
30        echo "  結果: 有効な浮動小数点数です。検証後の値: " . $result2 . " (型: " . gettype($result2) . ")\n";
31    } else {
32        echo "  結果: 無効な浮動小数点数です。\n";
33    }
34    echo "\n";
35
36    // 例3: 無効な文字列
37    $value3 = "hello_world";
38    $result3 = filter_var($value3, FILTER_VALIDATE_FLOAT);
39    echo "値 '{$value3}' の検証:\n";
40    if ($result3 !== false) {
41        echo "  結果: 有効な浮動小数点数です。検証後の値: " . $result3 . " (型: " . gettype($result3) . ")\n";
42    } else {
43        echo "  結果: 無効な浮動小数点数です。\n";
44    }
45    echo "\n";
46
47    // 例4: 部分的に数字だが無効な形式
48    $value4 = "123.45a";
49    $result4 = filter_var($value4, FILTER_VALIDATE_FLOAT);
50    echo "値 '{$value4}' の検証:\n";
51    if ($result4 !== false) {
52        echo "  結果: 有効な浮動小数点数です。検証後の値: " . $result4 . " (型: " . gettype($result4) . ")\n";
53    } else {
54        echo "  結果: 無効な浮動小数点数です。\n";
55    }
56    echo "\n";
57}
58
59// 関数を実行して、浮動小数点数検証のデモンストレーションを開始
60validateFloatExamples();

PHPのFILTER_VALIDATE_FLOATは、入力された値が有効な浮動小数点数（小数を含む数値）の形式であるかを検証するための定数です。この定数自体には引数はなく、内部的には特定の整数値として扱われますが、主にfilter_var()関数のようなフィルタリング関数と組み合わせてその検証方法を指定するために利用されます。

サンプルコードでは、filter_var()関数の第二引数にFILTER_VALIDATE_FLOATを指定することで、様々な文字列が浮動小数点数として妥当であるかをチェックしています。filter_var()関数は、検証に成功した場合、入力された文字列を浮動小数点数型に変換した値を返します。例えば、「123.45」のような文字列はもちろん、小数点を含まない「987」のような整数値も浮動小数点数として有効と判断され、それぞれfloat型の123.45や987.0として返されます。一方、入力値が有効な浮動小数点数の形式ではない場合（例: 「hello_world」や「123.45a」のように数字以外の文字が含まれる場合）、filter_var()関数はfalseを返します。

この機能は、ユーザーからの入力データが数値であることを確実に検証し、プログラムの誤動作を防ぐために非常に重要な役割を果たします。