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

<?php

/**
 * サンプルクラスA
 */
class MyClassA
{
    public function __construct()
    {
        // コンストラクタ
    }
}

/**
 * サンプルクラスB
 */
class MyClassB
{
    public static function someStaticMethod(): void
    {
        // 静的メソッド
    }
}

// get_declared_classes() は、スクリプト実行中に定義されている全てのクラス名を配列で返します。
// これには、ユーザー定義クラスだけでなく、PHP の内部クラスも含まれます。
$declaredClasses = get_declared_classes();

echo "現在定義されているクラス一覧:\n";
echo "---------------------------------\n";

// 見やすくするために、定義したばかりのユーザー定義クラスに絞って表示することもできますが、
// ここでは関数が返す全てのクラスを表示します。
foreach ($declaredClasses as $className) {
    echo $className . "\n";
}

echo "---------------------------------\n";
echo "上記リストには、ユーザー定義クラス (MyClassA, MyClassB など) と、\n";
echo "PHP が提供する内部クラス (StdClass, Exception など) の両方が含まれます。\n";

?>

PHP 8.4のget_declared_classes関数は、現在スクリプトの実行中にPHP環境内で利用可能なすべてのクラスの名前を、文字列の配列として取得する際に使用します。この関数は引数を一切受け付けず、戻り値として宣言済みのクラス名が格納された配列（array）を返します。

サンプルコードでは、MyClassAとMyClassBという2つのカスタムクラスを事前に定義しています。その後、get_declared_classes()関数を呼び出すことで、これらのユーザー定義クラスに加え、StdClassやExceptionといったPHPが内部的に提供する様々な組み込みクラスの名前もすべて網羅した配列が$declaredClasses変数に格納されます。この配列をループ処理で表示することにより、PHP環境が認識しているクラスの一覧を動的に確認できます。これにより、スクリプト実行時にどのようなクラスが存在しているかを把握し、プログラムの振る舞いを理解するのに役立ちます。

<?php

/**
 * サンプルクラスAを定義します。
 */
class SampleClassA
{
    public function __construct()
    {
        // コンストラクタ
    }
}

/**
 * サンプルクラスBを定義します。
 */
class SampleClassB
{
    public static function staticMethod()
    {
        return "Static method called.";
    }
}

/**
 * PHPスクリプト内で宣言されているすべてのクラス名を取得し、表示します。
 * get_declared_classes() は、スクリプト実行時までに定義されているクラス（
 * PHP組み込みクラス、ユーザー定義クラス、ロードされたライブラリのクラスなど）
 * の名前を配列として返します。
 */
function displayDeclaredClasses(): void
{
    echo "--- 宣言されているクラス一覧 ---\n";

    // 宣言されているクラスの配列を取得
    $declaredClasses = get_declared_classes();

    // クラス名をアルファベット順にソートすると見やすくなります
    sort($declaredClasses);

    foreach ($declaredClasses as $className) {
        echo "- " . $className . "\n";
    }

    echo "--- 表示終了 ---\n";
}

// 関数を実行して、宣言されているクラスを表示
displayDeclaredClasses();

?>

PHPのget_declared_classes関数は、PHPスクリプトが実行された時点で、現在までに宣言されているすべてのクラスの名前を取得するための内部関数です。この関数は引数をとりません。戻り値は配列（array）であり、その配列には宣言されているクラス名が文字列として格納されます。

取得されるクラス名には、サンプルコードで定義されているSampleClassAやSampleClassBのようなユーザー定義クラスに加え、PHPが標準で提供する組み込みクラスや、スクリプト内でロードされたライブラリのクラスも含まれます。

サンプルコードでは、SampleClassAとSampleClassBという2つのユーザー定義クラスを宣言した後、displayDeclaredClasses関数内でget_declared_classes()を呼び出しています。この呼び出しにより、それまでに宣言されたすべてのクラス名が配列として取得されます。取得したクラス名の配列はアルファベット順にソートされ、その後foreachループを使って各クラス名が画面に出力されます。この関数は、実行中のPHP環境でどのようなクラスが利用可能であるかを動的に確認したり、特定のクラスの存在を検証したりするデバッグなどの場面で役立ちます。

<?php

namespace App\Models {
    class User
    {
        public function __construct()
        {
            // Constructor logic
        }
    }

    class Product
    {
        public function __construct()
        {
            // Constructor logic
        }
    }
}

namespace App\Services {
    class AuthService
    {
        public function __construct()
        {
            // Constructor logic
        }
    }
}

namespace App\Utils {
    class Helper
    {
        public function __construct()
        {
            // Constructor logic
        }
    }
}

// Global scope class
class GlobalClass
{
    public function __construct()
    {
        // Constructor logic
    }
}

/**
 * 特定のネームスペースに属する宣言済みクラスを検索し、表示する関数です。
 *
 * @param string $namespaceName 検索対象のネームスペース名 (例: 'App\Models')
 * @return void
 */
function findClassesInNamespace(string $namespaceName): void
{
    // 全ての宣言済みクラスを取得
    $allDeclaredClasses = get_declared_classes();
    $foundClasses = [];

    echo "=== ネームスペース '{$namespaceName}' 内のクラス検索 ===\n";

    foreach ($allDeclaredClasses as $className) {
        // クラス名が指定されたネームスペースで始まるかチェック
        // ネームスペース名の後にバックスラッシュがあることを確認することで、
        // 'App\Model' と 'App\Models' のような誤判定を防ぐ
        if (str_starts_with($className, $namespaceName . '\\')) {
            $foundClasses[] = $className;
        }
    }

    if (empty($foundClasses)) {
        echo "指定されたネームスペース内でクラスは見つかりませんでした。\n";
    } else {
        echo "見つかったクラス:\n";
        foreach ($foundClasses as $class) {
            echo "- {$class}\n";
        }
    }
    echo "\n";
}

// 例として、異なるネームスペースで関数を実行
findClassesInNamespace('App\Models');
findClassesInNamespace('App\Services');
findClassesInNamespace('App\Utils');
findClassesInNamespace('NonExistent\Namespace');

?>

PHPのget_declared_classes関数は、現在スクリプトが読み込んで認識している全てのクラス名を、文字列の配列として取得する組み込み関数です。この関数は引数を一切必要とせず、宣言されているクラス名のリストを返します。

提供されたサンプルコードは、このget_declared_classes関数を使って、特定のネームスペースに属するクラスだけを抽出する方法を示しています。コードでは、App\ModelsやApp\Servicesといった異なるネームスペース内に複数のクラスが定義されています。findClassesInNamespaceという関数は、まずget_declared_classes()を呼び出し、これら全ての宣言済みクラスの名前を一覧として取得します。その後、取得したクラス名のリストを一つずつ確認し、引数で渡されたネームスペース名でクラス名が始まるかどうかをstr_starts_with関数で判定します。この際、ネームスペース名の後にバックスラッシュを加えることで、例えば「App\Model」と「App\Models」のように似た名前のネームスペースを正確に区別し、目的のネームスペースに属するクラスだけを確実に特定しています。最終的に、指定されたネームスペース内で見つかったクラス名が表示され、アプリケーション内のクラス管理に役立てることができます。