## 依賴注入 (Bean) MixPHP 參考了 Java Spring 的依賴注入(DI)與控制反轉(IoC)，具體實現就是通過 Bean 的方式，MixPHP 的實現是非常簡單高效的，并且可獨立使用，基于 [PSR-11](https://www.php-fig.org/psr/psr-11/) 標準實現。 ## 安裝 框架默認有安裝 ~~~ composer require mix/bean ~~~ ## 依賴配置 負責描述依賴注入的結構關系，在 mix 里對應 manifest.php 文件的 `beans` 或者 `beanPath` 字段 (框架會遍歷目錄讀取全部依賴配置)，依賴配置是一個數組，其中每一個節點為一個 `bean` ，每個 `bean` 包含以下屬性： - name：依賴名稱，默認等于 class 的值，通常只有在一個類需多次注入不同屬性時使用，需給相同的類定義不同的名稱。 - scope：作用域，值可為：BeanDefinition::PROTOTYPE 每次獲取新的實例、BeanDefinition::SINGLETON 獲取單例 - class：類的路徑，通常使用 ::class 的方式獲取 - properties：屬性注入，配置為需注入的屬性，內部的 key 將注入成類的屬性名稱，value 將賦值為屬性的值。 - constructorArgs：構造參數注入，配置為需注入的參數，參數將依順序傳遞給類的構造函數。 - ref：引用的另一個 `bean` 的 `name` 以下是一個日志類的依賴配置范例： - 最終被調用的是 Logger 類，所以該類定義了 name，方便重寫類功能時無需修改業務代碼，只需修改依賴配置即可 ，其他類因為在當前程序中只有使用一次，所以都沒有定義單獨的 name ，因為默認 name 等于 class。 - 為了提升性能 Logger 類被定義為 BeanDefinition::SINGLETON 單例模式。 - 根據 Logger 類的源碼可知，該類構造函數并沒有強制要求傳入參數，所以采用屬性注入 (properties)，而 MultiHandler 類源碼只能通過構造函數實例化所以采用構造函數注入 (constructorArgs)。 - 范例一共定義了四個類，依賴關系都是通過 ref 來關聯的，其中 Logger 類的 handler 屬性注入了 MultiHandler 類的實例，而 MultiHandler 類實例初始化時注入了一個對象數組，對象數組為 StdoutHandler / FileHandler 兩個類，而 FileHandler 類在實例化時又注入了一些配置參數。 ~~~ // 依賴配置 'beans' => [ // 日志 [ // 名稱 'name' => 'log', // 作用域 'scope' => \Mix\Bean\BeanDefinition::SINGLETON, // 類路徑 'class' => \Mix\Log\Logger::class, // 屬性注入 'properties' => [ // 日志記錄級別 'levels' => ['emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug'], // 處理器 'handler' => ['ref' => \Mix\Log\MultiHandler::class], ], ], // 日志處理器 [ // 類路徑 'class' => \Mix\Log\MultiHandler::class, // 構造函數注入 'constructorArgs' => [ // 標準輸出處理器 ['ref' => \Mix\Log\StdoutHandler::class], // 文件處理器 ['ref' => \Mix\Log\FileHandler::class], ], ], // 日志標準輸出處理器 [ // 類路徑 'class' => \Mix\Log\StdoutHandler::class, ], // 日志文件處理器 [ // 類路徑 'class' => \Mix\Log\FileHandler::class, // 屬性注入 'properties' => [ // 日志目錄 'dir' => dirname(__DIR__) . DIRECTORY_SEPARATOR . 'runtime' . DIRECTORY_SEPARATOR . 'logs', // 日志輪轉類型 'rotate' => \Mix\Log\FileHandler::ROTATE_DAY, // 最大文件尺寸 'maxFileSize' => 0, ], ], ], ~~~ ## 通過依賴注入實例化 由于 mix 的命令行 App 啟動時，已經在內部通過依賴配置信息初始化了一個 context 的屬性，該屬性為 Mix\Bean\ApplicationContext 的實例，負責 Bean 的調度： ``` // 獲取context $context = app()->context; // 簡化調用 $context = context(); ``` 因此以下方法即可在 mix 中通過依賴注入實例化一個類： - 通過依賴名稱獲取類實例 ``` $object = context()->get($beanName); ``` - 通過依賴名稱獲取類實例并傳入參數 ``` $params = [ 'request' => $request, 'response' => $response, ]; $object = context()->getBean($beanName, $params); ``` ## 類型注釋 由于 PHP 是弱類型語言，因此通過依賴注入獲取的實例并沒有 IDE 的類型提示，因此我們需要借助 PHPDoc 來標注類型： ``` /** @var Logger $log */ $log= context()->get('log'); ``` 當然也可以把對象傳值給類的屬性，通過給類屬性加 PHPDoc 來標注類型。 ``` /** * @var Logger */ public $log; public function __construct() { $this->log = context()->get('log'); } ```