IoC容器

本文是依赖注入(Depeendency Injection)系列教程的第 2 篇文章,本系列教程主要讲解如何使用 PHP 实现一个轻量级服务容器,教程包括:


术语

  • Depeendency Injection 译作 依赖注入
  • Depeendency Injection Container 译作 依赖注入容器
  • Container 译作 容器
  • Service Container 译作 服务容器
  • Session 译作 会话
  • Object-Oriented 译作 面向对象
  • mock 译作 模拟
  • anti-patterns 译作 反模式
  • hardcoded 译作 硬编码

正文

在上一篇 什么是依赖注入 一文中,我从 Web 项目的角度出发,结合实例讲解了「依赖注入」的具体实现。这一篇文章将谈谈「依赖注入容器」。

首先,表名我的观点:

一般使用「依赖注入」就够了,极少数情况需要使用「依赖注入容器」。

仅当需要管理大量依赖组件的实例时,才能真正体现「依赖注入容器」的价值(比如一个框架)。

如果你还记得 什么是依赖注入 中讲到的例子,在创建 User 实例之前,需要先创建 SessionStorage 实例。其实,这样也没什么不好,只不过您需要在充分了解所有依赖的组件后,才能着手创建对应的实例。

<?php
$storage = new SessionStorage('SESSION_ID');
$user = new User($storage);

本篇文章接下来的内容,我们将讨论 PHP 实现类似 Symfony 2 的「依赖注入容器」。我想明确的是,在实现「依赖注入容器」时不涉及 Symfony 相关功能,所以我将使用 Zend 框架示例来说明。

这边不涉及框架之争。我非常感谢 Zend 框架组件,事实上,Symfony 框架使用了许多 Zend 框架中的组件。

Zend Framework 的邮件组件可以轻松处理邮件管理工作,通常我们会使用 PHP 内建的 Mail() 函数发送电子邮件,但这不利于扩展。值得庆幸的是,使用 Zend 的邮件组件通过设置发送对象来修改邮件发送行为非常容易。如何使用 Gmail 帐号作为发送者创建 Zend_Mail 实例并发送一封邮件:

<?php
$transport = new Zend_Mail_Transport_Stmp('stmp.gmail.com', array(
  'auth'     => 'login',
  'username' => 'foo',
  'password' => 'bar',
  'ssl'      => 'ssl',
  'port'     => 465,
));

$mailer = new Zend_Mail();
$mailer->setDefaultTransport($transport);

为了使这篇文章简洁,我会使用一些简单的示例。当然,实际项目中对于如此简单的功能,其实没有必要去使用「容器」。那么把这个例子当作由容器管理的众多实例集合中的一个部分就可以了。

「依赖注入容器」是一个知道如何去实例化和配置依赖组件的对象。为了完成这样的工作,「依赖注入容器」需要知道构造函数参数及其对应的依赖组件的对应关系。

下面以硬编码的方式实现一个 Zend_Mail 容器:

<?php
class Container
{
    public function getMailTransport()
    {
        return new Zend_Mail_Transport_Stmp('stmp.gmail.com', array(
            'auth'     => 'login',
            'username' => 'foo',
            'password' => 'bar',
            'ssl'      => 'ssl',
            'port'     => 465,
        ));
    }

    public function getMailer()
    {
        $mailer = new Zend_Mail();
        $mailer->setDefaultTransport($this->getMailTransport());

        return $mailer;
    }
}

使用这个容器类也很简单:

<?php
$container = new Container();
$mailer = $container->getMailer();

在使用容器时,我们只需要获取一个 mailer 对象,而无需知道它是如何创建的;有关 mailer 实例创建的所有细节都有这个容器完成。mailer 对象所依赖的传输对象由调用容器的 getMailTransport() 方法自动注入到 mailer 对象中。容器的魔力仅需一个简单的方法调用即可实现。

等等,聪明如你怎么可能没有看出这个容器还不够完美呢 -- 它包含硬编码!因此,我们需要更进一步,将所需要的数据以构造函数的参数形式添加到容器内会更好:

<?php
class Container
{
    protected $parameters = array();

    public function __construct(array $parameters = array())
    {
        $this->parameters = $parameters;
    }

    public function getMailTransport()
    {
        return new Zend_Mail_Transport_Smtp('smtp.gmail.com', array(
        'auth'     => 'login',
        'username' => $this->parameters['mailer.username'],
        'password' => $this->parameters['mailer.password'],
        'ssl'      => 'ssl',
        'port'     => 465,
        ));
    }

    public function getMailer()
    {
        $mailer = new Zend_Mail();
        $mailer->setDefaultTransport($this->getMailTransport());

        return $mailer;
    }
}

现在可以很容易的修改 Gmail 帐号的用户名和密码了:

<?php
$container = new Container(array(
        'mailer.username' => 'foo',
        'mailer.password' => 'bar',
    ));

$mailer = $container->getMailer();

如果需要修改这个邮件发送器实现用于测试,还可以将邮件发送器类名作为参数设置到容器:

<?php
class Container
{
    public function getMailer()
    {
        $class = $this->parameters['mailer.class'];

        $mailer = new $class();
        $mailer->setDefaultTransport($this->getMailTransport());

        return $mailer;
    }
}

$container = new Container(array(
        'mailer.username' => 'foo',
        'mailer.password' => 'bar',
        'mailer.class' => 'Zend_Mail',
    ));

$mailer = $container->getMailer();

最后,一些优化,每次我想要获取一个邮件发送器实例 $mailer ,都需要创建一个新的实例。因此,可以将容器更改为始终返回相同的对象:

<?php
class Container
{
    static protected $shared = array();

    public function getMailer()
    {
        if (isset(self::$shared['mailer'])) {
            return self::$shared['mailer'];
        }

        $class = $this->parameters['mailer.class'];

        $mailer = new $class();
        $mailer->setDefaultTransport($this->getMailTransport());

        return self::$shared['mailer'] = $mailer;
    }
}

由于引入了一个 $shared 静态成员变量,这样每次调用 getMailer() 方法时,都会返回首次调用时创建的对象实例。

上面我们总结了依赖注入容器需要实现的基本特性。「依赖注入容器」用于管理依赖的对象实例:包含依赖组件的实例化和对组件所需配置的管理。依赖组件并不知道它是由容器管理的,或许依赖组件根本就不知道「依赖注入容器」的存在。这就是为什么容器能够管理任何 PHP 对象的奥秘。甚至,如果这些实例也使用依赖注入来管理自身的依赖,那就更加完美了,但这不是先决条件。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容