PHPで配列からコンストラクターに引数を渡す方法

PHPでは、Reflection API(リフレクションAPI)を利用することで、配列に格納された値をそのままコンストラクターに引数として渡すことができます。引数の個数や内容が動的に変わる場合に特に便利な機能です。

ReflectionClass::newInstanceArgs メソッドとは

ReflectionClass::newInstanceArgs は、指定された引数の配列をもとに、新しいクラスのインスタンスを生成するメソッドです。メソッドのシグネチャは以下の通りです。

public ReflectionClass::newInstanceArgs ([ array $args ] ) : object

このメソッドは、配列 $args の各要素をクラスのコンストラクターに順番に渡し、新しいインスタンスを作成して返します。引数を個別に指定する newInstance() とは異なり、引数をまとめて配列として渡せる点が特徴です。

サンプルコード

以下は、ReflectionFunction クラスのインスタンスを生成する際に、配列で引数「substr」を渡す例です。

<?php
    $my_class = new ReflectionClass('ReflectionFunction');
    $my_instance = $my_class->newInstanceArgs(array('substr'));
    var_dump($my_instance);
?>

実行結果

上記のコードを実行すると、以下のような出力が得られます。

object(ReflectionFunction)#2 (1) { ["name"]=> string(6) "substr" }

このように、newInstanceArgs を使えば、配列に格納された引数をそのままコンストラクターに渡してインスタンス化できます。設定値を配列で管理している場合や、実行時に渡す引数が決まっていない場合などに、柔軟なオブジェクト生成が可能になります。