PHPのリフレクションメカニズムを深く理解する

この記事では、PHP のリフレクション メカニズムについて詳しく説明します。一定の参考値があるので、困っている友達が参考になれば幸いです。

PHP のリフレクション メカニズムは、たとえばオブジェクトを通じてクラス、メソッド、プロパティ、パラメータ、注釈などにアクセスして使用するための一連のリフレクション API を提供します。このオブジェクトが属しているクラス、このクラスにどのようなメソッドが含まれているか、これらのメソッドに渡す必要があるパラメータ、各パラメータの型などがわかれば、クラスのインスタンスを作成せずにクラスのメンバーやメソッドにアクセスできます。クラスメンバーがプライベートとして定義されている場合でも、外部からアクセス可能です。

公式ドキュメントでは、ReflectionClass、ReflectionMethod、ReflectionObject、ReflectionExtension などのリフレクション クラスと対応する API が提供されており、最もよく使用されるのは ReflectionClass です。

リフレクション効果を実証するには、まずクラスを作成し (クラス User が定義されていると仮定します)、それをインスタンス化します。このインスタンスに基づいて、リフレクティブ クラスは User のプロパティとメソッドにアクセスできます。

<?php
/**
 * 用户相关类
 */
class User {
    public $username;
    private $password;

    public function __construct($username, $password)
    {
        $this->username = $username;
        $this->password = $password;
    }

    /**
     * 获取用户名
     * @return string
     */
    public function getUsername()
    {
        return $this->username;
    }

    /**
     * 设置用户名
     * @param string $username
     */
    public function setUsername($username)
    {
        $this->username = $username;
    }

    /**
     * 获取密码
     * @return string
     */
    private function getPassword()
    {
        return $this->password;
    }

    /**
     * 设置密码
     * @param string $password
     */
    private function setPassowrd($password)
    {
        $this->password = $password;
    }
}

リフレクション クラス インスタンスの作成

$refClass = new ReflectionClass(new User('liulu', '123456'));

// 也可以写成 
$refClass = new ReflectionClass('User'); // 将类名User作为参数，建立User类的反射类

リフレクション属性

$properties = $refClass->getProperties(); // 获取User类的所有属性，返回ReflectionProperty的数组
$property = $refClass->getProperty('password'); // 获取User类的password属性
//$properties 结果如下：
Array (
   [0] => ReflectionProperty Object ( [name] => username [class] => User )
   [1] => ReflectionProperty Object ( [name] => password [class] => User )
)   
//$property 结果如下：
ReflectionProperty Object ( [name] => password [class] => User )

リフレクション メソッド

$methods = $refClass->getMethods(); // 获取User类的所有方法，返回ReflectionMethod数组
$method = $refClass->getMethod('getUsername');  // 获取User类的getUsername方法

//$methods 结果如下：
Array (
    [0] => ReflectionMethod Object ( [name] => __construct [class] => User )
    [1] => ReflectionMethod Object ( [name] => getUsername [class] => User )
    [2] => ReflectionMethod Object ( [name] => setUsername [class] => User )
    [3] => ReflectionMethod Object ( [name] => getPassword [class] => User )
    [4] => ReflectionMethod Object ( [name] => setPassowrd [class] => User )
)
//$method 结果如下：
ReflectionMethod Object ( [name] => getUsername [class] => User )

リフレクション アノテーション

$classComment = $refClass->getDocComment();  // 获取User类的注释文档，即定义在类之前的注释
$methodComment = $refClass->getMethod('setPassowrd')->getDocComment();  // 获取User类中setPassowrd方法的注释
//$classComment 结果如下：
/** * 用户相关类 */
//$methodComment 结果如下：
/** * 设置密码 * @param string $password */

リフレクションのインスタンス化

$instance = $refClass->newInstance('admin', 123, '***');  // 从指定的参数创建一个新的类实例
//$instance 结果如下：
User Object ( [username] => admin [password:User:private] => 123 )
注：虽然构造函数中是两个参数，但是newInstance方法接受可变数目的参数，用于传递到类的构造函数。 

$params = ['xiaoming', 'asdfg'];
$instance = $refClass->newInstanceArgs($params); // 从给出的参数创建一个新的类实例
//$instance 结果如下：
User Object ( [username] => xiaoming [password:User:private] => asdfg )

クラスのパブリック メソッドにアクセスして実行します—public

$instance->setUsername('admin_1'); // 调用User类的实例调用setUsername方法设置用户名
$username = $instance->getUsername(); // 用过User类的实例调用getUsername方法获取用户名
echo $username . "\n"; // 输出 admin_1

// 也可以写成
$refClass->getProperty('username')->setValue($instance, 'admin_2'); // 通过反射类ReflectionProperty设置指定实例的username属性值
$username = $refClass->getProperty('username')->getValue($instance); // 通过反射类ReflectionProperty获取username的属性值
echo $username . "\n"; // 输出 admin_2

// 还可以写成
$refClass->getMethod('setUsername')->invoke($instance, 'admin_3'); // 通过反射类ReflectionMethod调用指定实例的方法，并且传送参数
$value = $refClass->getMethod('getUsername')->invoke($instance); // 通过反射类ReflectionMethod调用指定实例的方法
echo $value . "\n"; // 输出 admin_3

クラスの非パブリック メソッドにアクセスして実行します - プライベート、保護された

try {
    // 正确写法
    $property = $refClass->getProperty('password'); // ReflectionProperty Object ( [name] => password [class] => User )
    $property->setAccessible(true); // 修改 $property 对象的可访问性
    $property->setValue($instance, '987654321'); // 可以执行
    $value = $property->getValue($instance); // 可以执行
    echo $value . "\n";   // 输出 987654321

    // 错误写法
    $refClass->getProperty('password')->setAccessible(true); // 临时修改ReflectionProperty对象的可访问性
    $refClass->getProperty('password')->setValue($instance, 'password'); // 不能执行，抛出不能访问异常
    $refClass = $refClass->getProperty('password')->getValue($instance); // 不能执行，抛出不能访问异常
    $refClass = $instance->password;   // 不能执行，类本身的属性没有被修改，仍然是private
} catch (Exception $e){
    echo $e;
}

// 错误写法 结果如下：
ReflectionException: Cannot access non-public member User::password in xxx.php

概要

で定義されている属性とメソッドに関係なくリフレクションクラス public であれば取得可能です。 protected または private のプロパティとメソッドに直接アクセスすると、例外がスローされます。 非パブリック メンバーにアクセスするには、指定された ReflectionProperty または ReflectionMethod オブジェクト setAccessible(true) メソッドを呼び出す必要があります。

推奨学習: 「PHP ビデオ チュートリアル 」

以上がPHPのリフレクションメカニズムを深く理解するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。