理解PHP依赖注入容器(dependency injection container)系列(四) Symfony服务容器：利用Builder创建服务-CSDN博客

上篇讲述了利用继承sfServiceContainer类，为容器提供简单易用的接口调用。接下来我们会讲到如何进一步利用sfServiceContainerBuilder 类描述服务和配置。
sfServiceContainerBuilder是继承sfServiceContainer类的(每一个容器类如sfServiceContainer类都实现了sfServiceContainerInterface接口)，它使开发者可以通过一种简洁易用的方式来描述服务。

服务的描述是通过注册服务定义完成的。每个服务定义描述了一个服务：从使用构造函数传递参数的类，和一堆其他的配置属性（见下面的sfservicedefinition边栏）

再回到Zend_Mail这个例子，现在我们要把其中的硬编码去除掉，并利用builder类动态创建它

require_once 'PATH/TO/sf/lib/sfServiceContainerAutoloader.php';
sfServiceContainerAutoloader::register();

$sc = new sfServiceContainerBuilder();

$sc->
  register('mail.transport', 'Zend_Mail_Transport_Smtp')->
  addArgument('smtp.gmail.com')->
  addArgument(array(
    'auth'     => 'login',
    'username' => '%mailer.username%',
    'password' => '%mailer.password%',
    'ssl'      => 'ssl',
    'port'     => 465,
  ))->
  setShared(false)
;

$sc->
  register('mailer', '%mailer.class%')->
  addMethodCall('setDefaultTransport', array(new sfServiceReference('mail.transport')))
;

通过register()方法我们完成了对服务的创建。只需要给出service name和class name，该方法返回sfServiceDefinition实例。

服务定义在内部是通过sfservicedefinition对像实现的。也可以手工创建，再直接利用容器的setservicedefinition()方法登记。

sfServiceDefinition对像实现了一个接口并且提供了几个能对服务进行配置的方法，在上面的例子中，我们使用了这几个方法：

addArgument()：给服务的构造函数传递一个参数。
setShared()：在当前容器中，该服务是否唯一（默认情况下为true）
addMethodCall()：设置服务被创建后触发的委托事件。第一个参数是要委托调用的方法，第二个参数是向方法传递的参数数组

sfServiceDefinition 的相关方法：

setConstructor():设置创建服务时使用的静态方法，用来替换标准的new __construct方式(一般用在对像工厂)
setClass:设置服务类
setArguments(): 为构造函数设置多个参数（顺序很关键）
addArgument(): 为构造函数设置一个参数
setMethodCalls():设置服务被创建后触发的委托事件方法簇，按造顺序执行。
addMethodCall()：设置服务被创建后触发的委托事件，允许多次添加同一个方法。
setFile(): 设置一个文件包含路径，该文件将在创建服务前被引用include(在服务没有实现自动加载文件时有用)
setShared()：在当前容器中，该服务是否唯一（默认情况下为true）
setConfigurator():设置委托方法，在服务配置完成后调用。

现在引用一个服务是通过实例化sfServiceReference类来实现的(如：new sfServiceReference(‘mail.transport’) .)。这个特殊的类可以根据参数动态的创建服务。
在注册过程中，服务并没有真正被创建，仅仅是描述了如何获取并配置该服务。只有在真正使用服务时，服务才会被实例化。这就是说，你可以在任何顺序任何位置创建注册你的服务，而不用担心服务依赖的对像是否在它之前注册。这也意味着后面注册的服务如果名字相同，则可以覆盖前面的服务。在测试时，需要重写一些方法时这不失为一个好的办法。

sfServiceContainerBuilder类实现了标准sfServiceContainerInterface接口。来看一下接口定义：

interface sfServiceContainerInterface
{
    public function setParameters(array $parameters);
    public function addParameters(array $parameters);
    public function getParameters();
    public function getParameter($name);
    public function setParameter($name, $value);
    public function hasParameter($name);
    public function setService($id, $service);
    public function getService($id);
    public function hasService($name);
}

我们使用容器可以不用改变代码：

$sc->addParameters(array(
  'mailer.username' => 'foo',
  'mailer.password' => 'bar',
  'mailer.class'    => 'Zend_Mail',
));

$mailer = $sc->mailer;

sfServiceContainerBuilder 可以描述如何实例化、配置对像。上面的Zend_Mail例子已经展示了这一切，现在我们看另一个来源于Symfony的例子，这个例子用到了sfUser类:

$sc = new sfServiceContainerBuilder(array(
  'storage.class'        => 'sfMySQLSessionStorage',
  'storage.options'      => array('database' => 'session', 'db_table' => 'session'),
  'user.class'           => 'sfUser',
  'user.default_culture' => 'en',
));

$sc->register('dispatcher', 'sfEventDispatcher');

$sc->
  register('storage', '%storage.class%')->
  addArgument('%storage.options%')
;

$sc->
  register('user', '%user.class%')->
  addArgument(new sfServiceReference('dispatcher'))->
  addArgument(new sfServiceReference('storage'))->
  addArgument(array('default_culture' => '%user.default_culture%'))->
;

$user = $sc->user;