PHPのリフレクション機構-PHPチュートリアル-php.cn

リフレクションは一般に、プログラムが実行中にそれ自体を検査し、そのロジックを変更する機能として定義されます。あまり専門的ではない用語で言うと、リフレクションとは、オブジェクトにそのプロパティとメソッドを伝えるように要求し、それらのメンバー (プライベートメンバーも含む) を変更することです。このコースでは、これを実現する方法と、それがいつ役立つかを詳しく見ていきます。

ちょっとした歴史

プログラミング時代の初期に、アセンブリ言語が登場しました。アセンブリ言語で書かれたプログラムは、コンピュータ内の物理レジスタに存在します。その構成、メソッド、および値は、レジスタを読み取ることでいつでも確認できます。さらに、実行中にこれらのレジスタを変更するだけでプログラムを変更できます。実行中のプログラムに関する深い知識が必要ですが、本質的には反映的なものです。

他のクールなおもちゃと同様に、反射を使用しますが、乱用しないでください。

高級プログラミング言語 (C など) の出現により、この再帰性は徐々に消えていきました。その後、オブジェクト指向プログラミングを通じて再導入されました。

リフレクションは、最近ではほとんどのプログラミング言語で利用できます。 Java などの静的型付け言語では、リフレクションに関する問題がほとんどありません。しかし、PHP や Ruby のような動的型付け言語はリフレクションに大きく基づいているのは興味深いと思います。リフレクションの概念がなければ、ダックタイピングはおそらく不可能でしょう。オブジェクトを別のオブジェクト (パラメータなど) に送信する場合、受信側オブジェクトはオブジェクトの構造と型を知る方法がありません。できることは、リフレクションを使用して、受信したオブジェクトに対して呼び出せるメソッドと呼び出せないメソッドを識別することだけです。

簡単な例

リフレクションは PHP では一般的です。実際、知らず知らずのうちに使用している可能性がある状況がいくつかあります。例えば：＃＃＃リーリー＃＃＃その上：＃＃＃リーリー

このコードでは、既知の型でローカルに初期化された変数を直接呼び出します。

publishNextArticle()

でエディタを作成すると、

$editor 変数の型が Editor であることが明確にわかります。ここで反映する必要はありませんが、Manager: という名前の新しいクラスを導入します。リーリー 次に、Nettuts

を次のように変更します:

リーリー さて、Nettuts

は

Editor クラスとはまったく関係がありません。ファイルは含まれず、クラスも初期化されず、その存在さえ認識されません。任意のタイプのオブジェクトを publishNextArticle() メソッドに渡すことができ、コードは機能します。

このクラス図からわかるように、 PHPのリフレクション機構 Nettuts

は

Manager にのみ直接関連しています。 Manager は、Manager が Nettuts に依存するようにこれを作成します。ただし、Nettuts は Editor クラスとは何の関係もなくなり、Editor は Manager にのみ関連します。 実行時、Nettuts

は

Editor オブジェクトを使用するため、> と疑問符が付きます。実行時に、PHP は受信したオブジェクトを検査し、setNextArticle() メソッドと publish() メソッドが実装されていることを確認します。 オブジェクトメンバー情報

PHP にオブジェクトの詳細情報を表示させることができます。コードを簡単にテストできるように、PHPUnit テストを作成しましょう:

リーリー

次に、

var_dump()

を

Nettuts: に追加します。リーリー テストを実行し、出力で魔法が起こるのを確認してください: リーリー

私たちのリフレクションクラスには、

name

プロパティが

$editor 変数の元の型である Editor に設定されていますが、これはそれほど多くの情報ではありません。 Editor メソッドはどうでしょうか? リーリー このコードでは、リフレクションクラスのインスタンスを $reflector

変数に割り当てて、そのメソッドをトリガーできるようにします。

ReflectionClass オブジェクトに関する情報を取得するために使用できる多数のメソッドを公開します。これらのメソッドの 1 つは getMethods() で、各メソッドに関する情報を含む配列を返します。 リーリー 別のメソッド getProperties()

は、オブジェクトのプロパティ (プライベートプロパティも) を取得します。

リーリー getMethod() および

getProperties()

から返される配列内の要素は、それぞれ ReflectionMethod および ReflectionProperty 型です。非常に便利なオブジェクト:リーリーここでは、getMethod() を使用して、「publish」という名前の単一メソッドを取得します。結果は、

ReflectionMethod

オブジェクトです。次に、invoke() メソッドを呼び出し、$editor オブジェクトを渡して、エディタの publish() メソッドを再度実行します。 <p>在我们的例子中，这个过程很简单，因为我们已经有一个 <code>Editor 对象传递给 invoke()。在某些情况下，我们可能有多个 Editor 对象，这使我们可以自由选择使用哪个对象。在其他情况下，我们可能没有可以使用的对象，在这种情况下，我们需要从 ReflectionClass 获取一个对象。

我们来修改Editor的publish()方法来演示双重调用：

// Editor.php

class Editor {

	[ ... ]

	public function publish() {
		// publish logic goes here
		echo ("HERE\n");
		return true;
	}

}

ログイン後にコピー

新的输出：

PHPUnit 3.6.11 by Sebastian Bergmann.

.HERE
HERE

Time: 0 seconds, Memory: 2.25Mb

OK (1 test, 0 assertions)

ログイン後にコピー

操作实例数据

我们还可以在执行时修改代码。修改没有公共设置器的私有变量怎么样？让我们向 Editor 添加一个方法来检索编辑器的名称：

// Editor.php

class Editor {

	private $name;
	public $articleId;

	function __construct($name) {
		$this->name = $name;
	}

	[ ... ]

	function getEditorName() {
		return $this->name;
	}

}

ログイン後にコピー

这个新方法被称为 getEditorName()，并且仅返回私有 $name 变量的值。 $name 变量是在创建时设置的，我们没有公共方法可以让我们更改它。但我们可以使用反射来访问这个变量。您可能首先尝试更明显的方法：

// Nettuts.php

class Nettuts {

	function publishNextArticle($editor) {
		var_dump($editor->getEditorName());

		$reflector = new ReflectionClass($editor);
		$editorName = $reflector->getProperty('name');
		$editorName->getValue($editor);

	}

}

ログイン後にコピー

尽管这会在 var_dump() 行输出值，但在尝试通过反射检索该值时会引发错误：

PHPUnit 3.6.11 by Sebastian Bergmann.

Estring(8) "John Doe"


Time: 0 seconds, Memory: 2.50Mb

There was 1 error:

1) ReflectionTest::testItCanReflect
ReflectionException: Cannot access non-public member Editor::name

[...]/Reflection in PHP/Source/NetTuts.php:13
[...]/Reflection in PHP/Source/Tests/ReflectionTest.php:13
/usr/bin/phpunit:46

FAILURES!
Tests: 1, Assertions: 0, Errors: 1.

ログイン後にコピー

为了解决这个问题，我们需要请求 ReflectionProperty 对象授予我们访问私有变量和方法的权限：

// Nettuts.php

class Nettuts {

	function publishNextArticle($editor) {
		var_dump($editor->getEditorName());

		$reflector = new ReflectionClass($editor);
		$editorName = $reflector->getProperty('name');
		$editorName->setAccessible(true);
		var_dump($editorName->getValue($editor));
	}

}

ログイン後にコピー

调用 setAccessible() 并传递 true 可以解决问题：

PHPUnit 3.6.11 by Sebastian Bergmann.

.string(8) "John Doe"
string(8) "John Doe"


Time: 0 seconds, Memory: 2.25Mb

OK (1 test, 0 assertions)

ログイン後にコピー

如您所见，我们已成功读取私有变量。第一行输出来自对象自己的 getEditorName() 方法，第二行来自反射。但是改变私有变量的值又如何呢？使用 setValue() 方法：

// Nettuts.php

class Nettuts {

	function publishNextArticle($editor) {
		var_dump($editor->getEditorName());

		$reflector = new ReflectionClass($editor);
		$editorName = $reflector->getProperty('name');
		$editorName->setAccessible(true);
		$editorName->setValue($editor, 'Mark Twain');
		var_dump($editorName->getValue($editor));
	}

}

ログイン後にコピー

就是这样。此代码将“John Doe”更改为“Mark Twain”。

PHPUnit 3.6.11 by Sebastian Bergmann.

.string(8) "John Doe"
string(10) "Mark Twain"


Time: 0 seconds, Memory: 2.25Mb

OK (1 test, 0 assertions)

ログイン後にコピー

间接反射的使用

PHP 的一些内置功能间接使用反射，其中一个是 call_user_func() 函数。

回调

call_user_func() 函数接受一个数组：第一个元素指向对象，第二个元素指向方法的名称。您可以提供一个可选参数，然后将其传递给被调用的方法。例如：

// Nettuts.php

class Nettuts {

	function publishNextArticle($editor) {
		var_dump($editor->getEditorName());

		$reflector = new ReflectionClass($editor);
		$editorName = $reflector->getProperty('name');
		$editorName->setAccessible(true);
		$editorName->setValue($editor, 'Mark Twain');
		var_dump($editorName->getValue($editor));

		var_dump(call_user_func(array($editor, 'getEditorName')));
	}

}

ログイン後にコピー

以下输出表明代码检索了正确的值：

PHPUnit 3.6.11 by Sebastian Bergmann.

.string(8) "John Doe"
string(10) "Mark Twain"
string(10) "Mark Twain"


Time: 0 seconds, Memory: 2.25Mb

OK (1 test, 0 assertions)

ログイン後にコピー

使用变量的值

间接反射的另一个示例是通过变量中包含的值来调用方法，而不是直接调用它。例如：

// Nettuts.php

class Nettuts {

	function publishNextArticle($editor) {
		var_dump($editor->getEditorName());

		$reflector = new ReflectionClass($editor);
		$editorName = $reflector->getProperty('name');
		$editorName->setAccessible(true);
		$editorName->setValue($editor, 'Mark Twain');
		var_dump($editorName->getValue($editor));

		$methodName = 'getEditorName';
		var_dump($editor->$methodName());
	}

}

ログイン後にコピー

此代码产生与前面示例相同的输出。 PHP 只是用它所代表的字符串替换该变量并调用该方法。当您想通过使用类名变量来创建对象时，它甚至可以工作。