【PHP8.x】get_debug_type関数の使い方

Copy
1<?php
2
3/**
4 * get_debug_type() 関数の基本的な使用方法を示すサンプルコード。
5 *
6 * この関数はPHP 8で導入され、変数や値のデバッグに適した型名を返します。
7 * 特にオブジェクトの型名については、gettype() よりも詳細な情報を提供します。
8 */
9function showGetDebugTypeExamples(): void
10{
11    echo "--- スカラ型 ---" . PHP_EOL;
12    // null値の型
13    $nullValue = null;
14    echo "nullValue (" . var_export($nullValue, true) . "): " . get_debug_type($nullValue) . PHP_EOL;
15
16    // 真偽値の型
17    $boolValue = true;
18    echo "boolValue (" . var_export($boolValue, true) . "): " . get_debug_type($boolValue) . PHP_EOL;
19
20    // 整数の型
21    $intValue = 123;
22    echo "intValue (" . var_export($intValue, true) . "): " . get_debug_type($intValue) . PHP_EOL;
23
24    // 浮動小数点数の型
25    $floatValue = 3.14;
26    echo "floatValue (" . var_export($floatValue, true) . "): " . get_debug_type($floatValue) . PHP_EOL;
27
28    // 文字列の型
29    $stringValue = "Hello, World!";
30    echo "stringValue (" . var_export($stringValue, true) . "): " . get_debug_type($stringValue) . PHP_EOL;
31    echo PHP_EOL;
32
33    echo "--- 複合型 ---" . PHP_EOL;
34    // 配列の型
35    $arrayValue = [1, 2, 'three'];
36    echo "arrayValue: " . get_debug_type($arrayValue) . PHP_EOL;
37
38    // 標準クラス (stdClass) のインスタンスの型
39    $stdObject = new stdClass();
40    echo "stdObject: " . get_debug_type($stdObject) . PHP_EOL;
41    echo PHP_EOL;
42
43    echo "--- ユーザー定義クラスと無名クラス ---" . PHP_EOL;
44    // ユーザー定義クラスの例
45    class MyCustomClass
46    {
47        public string $name = "Custom";
48    }
49    $myObject = new MyCustomClass();
50    echo "myObject: " . get_debug_type($myObject) . PHP_EOL;
51
52    // 無名クラスの例 (PHP 7 以降で利用可能)
53    $anonymousObject = new class {
54        public function __construct()
55        {
56            // 無名クラスのコンストラクタ
57        }
58    };
59    echo "anonymousObject: " . get_debug_type($anonymousObject) . PHP_EOL;
60    echo PHP_EOL;
61
62    echo "--- リソース型 ---" . PHP_EOL;
63    // リソース型の例 (ファイルポインタ)
64    // 一時ファイルを作成してリソースを取得
65    $tempResource = tmpfile();
66    if ($tempResource !== false) {
67        echo "tempResource: " . get_debug_type($tempResource) . PHP_EOL;
68        fclose($tempResource); // リソースを解放
69    } else {
70        echo "Warning: Failed to create temporary resource for demonstration." . PHP_EOL;
71    }
72}
73
74// サンプル関数を実行して結果を表示
75showGetDebugTypeExamples();
76

PHP 8から導入されたget_debug_type関数は、変数の型をデバッグに役立つ形式で取得するために使用されます。この関数はmixed $valueという引数であらゆる型の値を受け取り、その値の型を示すstring型の文字列を返します。従来のgettype()関数と異なり、オブジェクトに対してはクラス名を具体的に返すため、stdClassやユーザー定義クラス、無名クラスなど、オブジェクトの種類をより詳細に判別できます。

サンプルコードでは、null、真偽値、整数、浮動小数点数、文字列といった基本的なスカラ型から、配列、標準オブジェクト、自作クラスのインスタンス、さらにはファイルリソースのようなリソース型まで、様々なデータ型がget_debug_type関数によってどのように評価されるかを示しています。それぞれの値に対して、正確なデバッグ用型名を取得できることが確認できます。この関数は、予期せぬ型の値が渡された際の原因究明や、コードの動作確認において、非常に強力なツールとして役立ちます。