## Bean MixPHP 参考了 Java Spring 的依赖注入(DI)与控制反转(IoC),具体实现就是通过 Bean 的方式,MixPHP 的实现是非常简单高效的。 | 类 | | --- | | Mix\Core\Bean\AbstractObject | 整体实现分为几个部分: - 配置文件:`beans` 配置项负责描述依赖注入的结构关系。 - AbstractObject:抽象类 `AbstractObject ` 负责属性导入与对象实例化。 ## `beans` 配置项 应用配置文件中,有一个 `beans` 配置项,这里描述了框架使用的所有类的依赖关系。 `beans` 配置项是一个数组,其中每一个节点为一个 `bean` ,每个 `bean` 包含三个属性: - class:类的路径,通常使用 ::class 的方式获取 - name:默认等于 class 的值,通常只有在一个类需多次注入不同属性时使用,需给相同的类定义不同的名称。 - properties:需注入的属性,内部的 key 将注入成类的属性名称,value 将赋值为属性的值。 - ref:引用的另一个 `bean` 的 `name`,由于没有配置 `name` 的 `bean` 默认会通过 `class` 生成一个名称,所以框架提供了 `beanname` 方法方便用户获取默认名称。 下面是一个授权组件的依赖关系配置: ~~~ // 依赖配置 'beans' => [ // Auth [ // 类路径 'class' => Mix\Auth\Authorization::class, /** 名称:通常不需要配置这个属性,因为默认框架会生成一个 name, 值等于 beanname(class),只有在同一个类需要不同配置时才需自行配置名字, 这时就不需要使用 beanname 方法命名了,直接指定一个字符串的名称即可, 在其他类中 ref 引用时,也不需要使用 beanname 方法。 // 默认生成的名称 'name' => beanname(Mix\Auth\Authorization::class), // 自定义名称 'name' => 'newName', */ // 属性 'properties' => [ // BearerToken 'bearerToken' => [ // 依赖引用 'ref' => beanname(Mix\Auth\BearerToken::class), ], // jwt 'jwt' => [ // 依赖引用 'ref' => beanname(Mix\Auth\JWT::class), ], ], ], // BearerToken [ // 类路径 'class' => Mix\Auth\BearerToken::class, ], // jwt [ // 类路径 'class' => Mix\Auth\JWT::class, // 属性 'properties' => [ // 钥匙 'key' => 'example_key', // 签名算法 'algorithm' => Mix\Auth\JWT::ALGORITHM_HS256, ], ], ], ~~~ ## 通过依赖注入实例化 上文的授权组件的依赖关系配置中,由于 Authorization 继承了 AbstractObject ,因此可以非常方便的实例化: ``` // 使用默认 beanname 实例化 $auth = Mix\Auth\Authorization::newInstance(); // 指定 beanname 实例化 $auth = Mix\Auth\Authorization::newInstance('beanname'); ``` ## AbstractObject 上面的依赖关系定义完成后,最终需要根据依赖注入到对象中,而完成注入工作的就是 AbstractObject 这个抽象类。 因此需要使用完整的依赖注入、控制反转,必须要继承该类,框架大部分类都继承自 AbstractObject 这个抽象类。 ### 第三方的类的依赖注入 通过使用 `Mix\Core\Bean\ObjectTrait` 手动处理第三方的类的依赖注入,代码如下: ~~~php class MyLibrary extends ThirdLibrary implements \Mix\Core\Bean\ObjectInterface { use Mix\Core\Bean\ObjectTrait; // 如果需要接收配置,可以在这里手动处理,$properties 就是传入的属性信息 public function __construct($properties = []) { parent::__construct(); } } ~~~ ### AbstractObject 的事件 包含了三个事件: - onConstruct:构造事件,相当于 __construct 方法。 - onInitialize:当完成构造事件并导入配置信息为属性后触发该事件,用于做一些初始化处理。 - onDestruct:析构事件,相当于 __destruct 方法。 使用时只需重写这几个事件方法即可。 ~~~php // 构造事件 public function onConstruct() { parent::onConstruct(); // ... } // 初始化事件 public function onInitialize() { parent::onInitialize(); // ... } // 析构事件 public function onDestruct() { parent::onDestruct(); // ... } ~~~