依賴自動注入

在webman裡依賴自動注入是可選功能，此功能默認關閉。如果你需要依賴自動注入，推薦使用php-di，以下是webman結合php-di的用法。

安裝

composer require psr/container ^1.1.1 php-di/php-di ^6 doctrine/annotations ^1.14

修改配置config/container.php，其最終內容如下：

$builder = new \DI\ContainerBuilder();
$builder->addDefinitions(config('dependence', []));
$builder->useAutowiring(true);
$builder->useAnnotations(true);
return $builder->build();

config/container.php裡最終返回一個符合PSR-11規範的容器實例。如果你不想使用php-di，可以在這裡創建並返回一個其它符合PSR-11規範的容器實例。

構造函數注入

新建app/service/Mailer.php(如目錄不存在請自行創建)內容如下：

<?php
namespace app\service;

class Mailer
{
    public function mail($email, $content)
    {
        // 發送郵件代碼省略
    }
}

app/controller/UserController.php內容如下：

<?php
namespace app\controller;

use support\Request;
use app\service\Mailer;

class UserController
{
    private $mailer;

    public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }

    public function register(Request $request)
    {
        $this->mailer->mail('hello@webman.com', 'Hello and welcome!');
        return response('ok');
    }
}

正常情況下，需要以下代碼才能完成app\controller\UserController的實例化：

$mailer = new Mailer;
$user = new UserController($mailer);

當使用php-di後，開發者無需手動實例化控制器中的Mailer，webman會自動幫你完成。如果在實例化Mailer過程中有其它類的依賴，webman也會自動實例化並注入。開發者不需要任何的初始化工作。

注意
必須是由框架或者php-di創建的實例才能完成依賴自動注入，手動new的實例無法完成依賴自動注入，如需注入，需要使用support\Container介面替換new語句，例如：

use app\service\UserService;
use app\service\LogService;
use support\Container;

// new關鍵字創建的實例無法依賴注入
$user_service = new UserService;
// new關鍵字創建的實例無法依賴注入
$log_service = new LogService($path, $name);

// Container創建的實例可以依賴注入
$user_service = Container::get(UserService::class);
// Container創建的實例可以依賴注入
$log_service = Container::make(LogService::class, [$path, $name]);

註解注入

除了構造函數依賴自動注入，我們還可以使用註解注入。繼續上面的例子，app\controller\UserController更改成如下：

<?php
namespace app\controller;

use support\Request;
use app\service\Mailer;
use DI\Annotation\Inject;

class UserController
{
    /**
     * @Inject
     * @var Mailer
     */
    private $mailer;

    public function register(Request $request)
    {
        $this->mailer->mail('hello@webman.com', 'Hello and welcome!');
        return response('ok');
    }
}

這個例子通過 @Inject 註解注入，並且由 @var 註解聲明對象類型。這個例子和構造函數注入效果一樣，但是代碼更精簡。

注意
webman在1.4.6版本之前不支持控制器參數注入，例如以下代碼當webman<=1.4.6時是不支持的

<?php
namespace app\controller;

use support\Request;
use app\service\Mailer;

class UserController
{
    // 1.4.6版本之前不支持控制器參數注入
    public function register(Request $request, Mailer $mailer)
    {
        $mailer->mail('hello@webman.com', 'Hello and welcome!');
        return response('ok');
    }
}

自定義構造函數注入

有時候構造函數傳入的參數可能不是類的實例，而是字符串、數字、數組等數據。例如Mailer構造函數需要傳遞smtp伺服器IP和端口：

<?php
namespace app\service;

class Mailer
{
    private $smtpHost;

    private $smtpPort;

    public function __construct($smtp_host, $smtp_port)
    {
        $this->smtpHost = $smtp_host;
        $this->smtpPort = $smtp_port;
    }

    public function mail($email, $content)
    {
        // 發送郵件代碼省略
    }
}

這種情況無法直接使用前面介紹的構造函數自動注入，因為php-di無法確定$smtp_host、$smtp_port的值是什麼。這時候可以嘗試自定義注入。

在config/dependence.php(檔案不存在請自行創建)中加入如下代碼：

return [
    // ... 這裡忽略了其他配置

    app\service\Mailer::class =>  new app\service\Mailer('192.168.1.11', 25);
];

這樣當依賴注入需要獲取app\service\Mailer實例時將自動使用這個配置中創建的app\service\Mailer實例。

我們注意到，config/dependence.php 中使用了new來實例化Mailer類，這個在本示例沒有任何問題，但是想象下如果Mailer類依賴了其他類的話或者Mailer類內部使用了註解注入，使用new初始化將不會依賴自動注入。解決辦法是利用自定義接口注入，通過Container::get(類名) 或者 Container::make(類名, [構造函數參數])方法來初始化類。

自訂介面注入

在實際項目中，我們更希望以介面編程，而不是具體的類別。例如，app\controller\UserController 應引入 app\service\MailerInterface 而不是 app\service\Mailer。

定義 MailerInterface 介面。

<?php
namespace app\service;

interface MailerInterface
{
    public function mail($email, $content);
}

定義 MailerInterface 介面的實現。

<?php
namespace app\service;

class Mailer implements MailerInterface
{
    private $smtpHost;

    private $smtpPort;

    public function __construct($smtp_host, $smtp_port)
    {
        $this->smtpHost = $smtp_host;
        $this->smtpPort = $smtp_port;
    }

    public function mail($email, $content)
    {
        // 發送郵件程式碼省略
    }
}

引入 MailerInterface 介面而非具體實現。

<?php
namespace app\controller;

use support\Request;
use app\service\MailerInterface;
use DI\Annotation\Inject;

class UserController
{
    /**
     * @Inject
     * @var MailerInterface
     */
    private $mailer;

    public function register(Request $request)
    {
        $this->mailer->mail('hello@webman.com', 'Hello and welcome!');
        return response('ok');
    }
}

在 config/dependence.php 中將 MailerInterface 介面定義如下實現。

use Psr\Container\ContainerInterface;
return [
    app\service\MailerInterface::class => function(ContainerInterface $container) {
        return $container->make(app\service\Mailer::class, ['smtp_host' => '192.168.1.11', 'smtp_port' => 25]);
    }
];

這樣當業務需要使用 MailerInterface 介面時，將自動使用 Mailer 實現。

面向介面編程的好處是，當我們需要更換某個組件時，不需要更改業務程式碼，只需要更改 config/dependence.php 中的具體實現即可。這在做單元測試也非常有用。

其它自訂注入

config/dependence.php 除了能定義類的依賴，也能定義其他值，例如字串、數字、陣列等。

例如 config/dependence.php 定義如下：

return [
    'smtp_host' => '192.168.1.11',
    'smtp_port' => 25
];

這時候我們可以通過 @Inject 將 smtp_host smtp_port 注入到類的屬性中。

<?php
namespace app\service;

use DI\Annotation\Inject;

class Mailer
{
    /**
     * @Inject("smtp_host")
     */
    private $smtpHost;

    /**
     * @Inject("smtp_port")
     */
    private $smtpPort;

    public function mail($email, $content)
    {
        // 發送郵件程式碼省略
        echo "{$this->smtpHost}:{$this->smtpPort}\n"; // 將輸出 192.168.1.11:25
    }
}

注意：@Inject("key") 裡面是雙引號

更多內容

請參考 php-di手冊