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

<?php

/**
 * 基本的な乗り物を表すクラス。
 */
class Vehicle
{
    // このクラスは継承の例のために定義されています。
    // 特に追加するプロパティやメソッドはありません。
}

/**
 * 車を表すクラス。Vehicleを継承します。
 */
class Car extends Vehicle
{
    // Carクラス独自のプロパティやメソッドをここに追加できます。
}

/**
 * スポーツカーを表すクラス。Carを継承します。
 */
class SportsCar extends Car
{
    // SportsCarクラス独自のプロパティやメソッドをここに追加できます。
}

echo "--- class_parents() の使用例 ---\n\n";

// 1. クラス名（文字列）を引数として渡す例
// 'SportsCar' クラスが直接または間接的に継承している全ての親クラスを取得します。
echo "1. 'SportsCar' クラスの親クラス:\n";
$parentsOfSportsCar = class_parents('SportsCar');

if ($parentsOfSportsCar !== false) {
    print_r($parentsOfSportsCar);
} else {
    echo "親クラスが見つかりませんでした。\n";
}
echo "\n";

// 2. オブジェクトを引数として渡す例
// 'SportsCar' クラスのインスタンスを作成し、そのオブジェクトの親クラスを取得します。
echo "2. 'SportsCar' オブジェクトの親クラス:\n";
$mySportsCar = new SportsCar();
$parentsOfObject = class_parents($mySportsCar);

if ($parentsOfObject !== false) {
    print_r($parentsOfObject);
} else {
    echo "親クラスが見つかりませんでした。\n";
}
echo "\n";

// 3. 別のクラスの例
// 'Car' クラスの親クラスを取得します。
echo "3. 'Car' クラスの親クラス:\n";
$parentsOfCar = class_parents('Car');

if ($parentsOfCar !== false) {
    print_r($parentsOfCar);
} else {
    echo "親クラスが見つかりませんでした。\n";
}
echo "\n";

// 結果の配列は、継承の深さに応じて上位のクラスから順に並びます。
// 例えば SportsCar の場合、Car (直接の親) -> Vehicle (Carの親) の順になります。

?>

PHPのclass_parents関数は、指定されたクラスやオブジェクトが直接的または間接的に継承している全ての親クラスのリストを取得するために使用します。この関数は、オブジェクト指向プログラミングにおけるクラスの継承関係を動的に調査する際に役立ちます。

引数には、親クラスを知りたいクラスの名前を文字列で渡すか、そのクラスのインスタンス（オブジェクト）を渡すことができます。オプションの第二引数$autoloadは、指定されたクラスが見つからない場合にPHPのオートロード機能を呼び出すかどうかを制御します。通常はtrueのままで問題ありません。 戻り値としては、継承の深さに応じて最も近い親クラスから順に、親クラスの名前が格納された配列が返されます。もし指定されたクラスに親クラスが存在しない場合や、クラスが見つからない場合はfalseが返されます。

サンプルコードでは、Vehicle、Car、SportsCarという継承関係を持つクラスを定義しています。class_parents関数を使い、'SportsCar'というクラス名を文字列として指定した場合と、new SportsCar()で作成したオブジェクトを指定した場合の両方で親クラスのリストを取得しています。これにより、SportsCarの親であるCarと、さらにその親であるVehicleが配列として取得される様子を確認できます。また、'Car'クラスの親クラスを取得する例も示されており、Carの親であるVehicleのみが返されることがわかります。このように、class_parents関数はクラスの継承チェーンを簡単にたどるための便利な機能です。