Отражение класса и внедрение зависимостей

задняя часть PHP Laravel обеспечить регресс
Отражение класса и внедрение зависимостей

Прежде чем говорить о контейнерах служб, я хочу разобраться в знаниях, связанных с отражением PHP.Отражение PHP является основой для программной реализации внедрения зависимостей, а также основой для контейнера служб Laravel для реализации анализа служб.Если вы освоили базовые знания в этой области, вы можете перейти непосредственно к просмотру содержимого раздела контейнера службы в этой статье.

PHP имеет API полного отражения, который предоставляет возможность обратного проектирования классов, интерфейсов, функций, методов и расширений. Благодаря возможности, предоставляемой отражением класса, мы можем узнать, как определяется класс, какие у него атрибуты, какие методы, какие параметры имеет метод, каков путь к файлу класса и другую важную информацию. Также официально из-за отражения классов многие PHP-фреймворки могут реализовывать внедрение зависимостей для автоматического разрешения зависимостей между классами, что значительно упрощает нашу обычную разработку. В этой статье в основном объясняется, как использовать отражение класса для реализации внедрения зависимостей, и не будет описываться каждый API в отражении PHP по отдельности.Подробную справочную информацию по API см.официальная документация

Опять же, внедрение зависимостей, реализованное здесь, очень просто и не может быть применено к реальной разработке.Вы можете обратиться к следующим статьям.Сервисный контейнер (IocContainer), чтобы понять, как сервисный контейнер Laravel реализует внедрение зависимостей.

Для лучшего понимания давайте рассмотрим отражение классов и реализацию внедрения зависимостей на примере. Следующий класс представляет точку в системе координат с двумя атрибутами: абсцисса x и ордината y.

/**
 * Class Point
 */
class Point
{
    public $x;
    public $y;

    /**
     * Point constructor.
     * @param int $x  horizontal value of point's coordinate
     * @param int $y  vertical value of point's coordinate
     */
    public function __construct($x = 0, $y = 0)
    {
        $this->x = $x;
        $this->y = $y;
    }
}

Далее, этот класс представляет круг.Вы можете видеть, что в его конструкторе есть параметр, которыйPointдобрый, т.е.Circleкласс зависит отPointКатегория.

class Circle
{
    /**
     * @var int
     */
    public $radius;//半径

    /**
     * @var Point
     */
    public $center;//圆心点

    const PI = 3.14;

    public function __construct(Point $point, $radius = 1)
    {
        $this->center = $point;
        $this->radius = $radius;
    }
    
    //打印圆点的坐标
    public function printCenter()
    {
        printf('center coordinate is (%d, %d)', $this->center->x, $this->center->y);
    }

    //计算圆形的面积
    public function area()
    {
        return 3.14 * pow($this->radius, 2);
    }
}

ReflectionClass

Далее мы используем отражение дляCircleЭтот класс реконструирован. ПучокCircleимя класса, переданногоreflectionClassсоздать экземплярReflectionClassобъект класса.

$reflectionClass = new reflectionClass(Circle::class);
//返回值如下
object(ReflectionClass)#1 (1) {
  ["name"]=>
  string(6) "Circle"
}

Отражение констант класса

$reflectionClass->getConstants();

Возвращает ассоциативный массив имен и значений констант.

array(1) {
  ["PI"]=>
  float(3.14)
}

Получить свойства через отражение

$reflectionClass->getProperties();

Возвращает массив объектов ReflectionProperty.

array(2) {
  [0]=>
  object(ReflectionProperty)#2 (2) {
    ["name"]=>
    string(6) "radius"
    ["class"]=>
    string(6) "Circle"
  }
  [1]=>
  object(ReflectionProperty)#3 (2) {
    ["name"]=>
    string(6) "center"
    ["class"]=>
    string(6) "Circle"
  }
}

Отражение методов, определенных в классе

$reflectionClass->getMethods();

Возвращает массив объектов ReflectionMethod

array(3) {
  [0]=>
  object(ReflectionMethod)#2 (2) {
    ["name"]=>
    string(11) "__construct"
    ["class"]=>
    string(6) "Circle"
  }
  [1]=>
  object(ReflectionMethod)#3 (2) {
    ["name"]=>
    string(11) "printCenter"
    ["class"]=>
    string(6) "Circle"
  }
  [2]=>
  object(ReflectionMethod)#4 (2) {
    ["name"]=>
    string(4) "area"
    ["class"]=>
    string(6) "Circle"
  }
}

Мы также можем пройтиgetConstructor()чтобы получить конструктор класса отдельно, а его возвращаемое значениеReflectionMethodобъект.

$constructor = $reflectionClass->getConstructor();

Отразить параметры метода

$parameters = $constructor->getParameters();

Его возвращаемое значение представляет собой массив объектов ReflectionParameter.

array(2) {
  [0]=>
  object(ReflectionParameter)#3 (1) {
    ["name"]=>
    string(5) "point"
  }
  [1]=>
  object(ReflectionParameter)#4 (1) {
    ["name"]=>
    string(6) "radius"
  }
}

внедрение зависимости

Хорошо, давайте напишемmakeфункция, передавая имя класса вmakeФункция возвращает объект класса, вmakeОн поможет нам внедрить зависимости класса, то есть в данном случае поможет нам внедритьPointВозражатьCircleконструктор класса.

//构建类的对象
function make($className)
{
    $reflectionClass = new ReflectionClass($className);
    $constructor = $reflectionClass->getConstructor();
    $parameters  = $constructor->getParameters();
    $dependencies = getDependencies($parameters);
    
    return $reflectionClass->newInstanceArgs($dependencies);
}

//依赖解析
function getDependencies($parameters)
{
    $dependencies = [];
    foreach($parameters as $parameter) {
        $dependency = $parameter->getClass();
        if (is_null($dependency)) {
            if($parameter->isDefaultValueAvailable()) {
                $dependencies[] = $parameter->getDefaultValue();
            } else {
                //不是可选参数的为了简单直接赋值为字符串0
                //针对构造方法的必须参数这个情况
                //laravel是通过service provider注册closure到IocContainer,
                //在closure里可以通过return new Class($param1, $param2)来返回类的实例
                //然后在make时回调这个closure即可解析出对象
                //具体细节我会在另一篇文章里面描述
                $dependencies[] = '0';
            }
        } else {
            //递归解析出依赖类的对象
            $dependencies[] = make($parameter->getClass()->name);
        }
    }

    return $dependencies;
}

четко определенныйmakeПосле метода мы используем его, чтобы помочь нам создавать экземпляры объектов класса Circle:

$circle = make('Circle');
$area = $circle->area();
/*var_dump($circle, $area);
object(Circle)#6 (2) {
  ["radius"]=>
  int(1)
  ["center"]=>
  object(Point)#11 (2) {
    ["x"]=>
    int(0)
    ["y"]=>
    int(0)
  }
}
float(3.14)*/

В приведенном выше примере я кратко описал, как использовать отражение классов PHP для внедрения зависимостей.Внедрение зависимостей в Laravel также осуществляется с помощью этой идеи, но конструкция более сложная и использует множество обратных вызовов закрытия для решения различных сложностей. Инъекция.

этой статьиСсылка для скачивания примера кода

Эта статья вошла в серию статейИзучение исходного кода Laravel, добро пожаловать в гости и читать.