如何在Zend Framework中使用依赖注入?

目前,我正在尝试学习Zend框架,因此我买了“Zend Framework in Action”一书。

在第 3 章中,介绍了一个基本模型和控制器,以及它们的单元测试。基本控制器如下所示:

class IndexController extends Zend_Controller_Action 
{
    public function indexAction()
    {
        $this->view->title = 'Welcome';
        $placesFinder = new Places();
        $this->view->places = $placesFinder->fetchLatest();
    }
}

Places是从数据库获取最新位置的模型类。我在这里遇到了什么问题:我应该如何单独测试?由于对类的引用是“硬编码的”,因此我无法在 中注入任何存根或模拟。IndexControllerPlacesIndexController

我宁愿拥有这样的东西:

class IndexController extends Zend_Controller_Action 
{
    private $placesFinder;

    // Here I can inject anything: mock, stub, the real instance
    public function setPlacesFinder($places)
    {
        $this->placesFinder = $places;
    }

    public function indexAction()
    {
        $this->view->title = 'Welcome';
        $this->view->places = $this->placesFinder->fetchLatest();
    }
}

我发布的第一个代码示例绝对不是单元测试友好的,因为不能单独测试。第二个要好得多。现在我只需要一些方法将模型实例注入控制器对象。IndexController

我知道Zend框架本身没有用于依赖注入的组件。但是PHP有一些很好的框架,可以与Zend框架一起使用吗?或者有没有其他方法可以在Zend Framework中做到这一点?


答案 1

模型逻辑

首先,值得一提的是,控制器应该只需要功能测试,尽管所有逻辑都属于模型。

我的实现

以下是我的操作控制器实现的摘录,它解决了以下问题:

  • 允许将任何依赖项注入到操作中
  • 验证操作参数,例如,当期望整数时,您可能无法传入数组$_GET

我的完整代码还允许生成基于或必需或已处理的操作参数的规范URL(用于SEO或统计信息的唯一页面哈希)。为此,我使用此抽象操作控制器和自定义请求对象,但这不是我们在这里讨论的情况。

显然,我使用反射来自动确定操作参数和依赖项对象。

这是一个巨大的优势,简化了代码,但也对性能有影响(在我的应用程序和服务器的情况下,这是最小的,并不重要),但你可以实现一些缓存来加快它。计算优点和缺点,然后决定。

DocBlock注释正在成为一个非常知名的行业标准,并且出于评估目的对其进行解析变得更加流行(例如,Doctrine 2)。我在许多应用程序中都使用了这种技术,并且效果很好。

写这门课时,我受到了行动的启发,现在有参数!Jani Hartikainen的博客文章

所以,这是代码:

<?php

/**
 * Enchanced action controller
 *
 * Map request parameters to action method
 *
 * Important:
 * When you declare optional arguments with default parameters, 
 * they may not be perceded by optional arguments,
 * e.g.
 * @example
 * indexAction($username = 'tom', $pageid); // wrong
 * indexAction($pageid, $username = 'tom'); // OK
 * 
 * Each argument must have @param DocBlock
 * Order of @param DocBlocks *is* important
 * 
 * Allows to inject object dependency on actions:
 * @example
 *   * @param int $pageid
 *   * @param Default_Form_Test $form
 *   public function indexAction($pageid, Default_Form_Test $form = null)
 *
 */
abstract class Your_Controller_Action extends Zend_Controller_Action
{  
    /**
     *
     * @var array
     */
    protected $_basicTypes = array(
        'int', 'integer', 'bool', 'boolean',
        'string', 'array', 'object',
        'double', 'float'
    );

    /**
     * Detect whether dispatched action exists
     * 
     * @param string $action
     * @return bool 
     */
    protected function _hasAction($action)
    {
        if ($this->getInvokeArg('useCaseSensitiveActions')) {
            trigger_error(
                    'Using case sensitive actions without word separators' .
                    'is deprecated; please do not rely on this "feature"'
            );

            return true;
        }

        if (method_exists($this, $action)) {

            return true;
        }

        return false;
    }

    /**
     *
     * @param string $action
     * @return array of Zend_Reflection_Parameter objects
     */
    protected function _actionReflectionParams($action)
    {
        $reflMethod = new Zend_Reflection_Method($this, $action);
        $parameters = $reflMethod->getParameters();

        return $parameters;
    }

    /**
     *
     * @param Zend_Reflection_Parameter $parameter
     * @return string
     * @throws Your_Controller_Action_Exception when required @param is missing
     */
    protected function _getParameterType(Zend_Reflection_Parameter $parameter)
    {
        // get parameter type
        $reflClass = $parameter->getClass();

        if ($reflClass instanceof Zend_Reflection_Class) {
            $type = $reflClass->getName();
        } else if ($parameter->isArray()) {
            $type = 'array';
        } else {
            $type = $parameter->getType();
        }

        if (null === $type) {
            throw new Your_Controller_Action_Exception(
                    sprintf(
                            "Required @param DocBlock not found for '%s'", $parameter->getName()
                    )
            );
        }

        return $type;
    }

    /**
     *
     * @param Zend_Reflection_Parameter $parameter 
     * @return mixed
     * @throws Your_Controller_Action_Exception when required argument is missing
     */
    protected function _getParameterValue(Zend_Reflection_Parameter $parameter)
    {
        $name = $parameter->getName();
        $requestValue = $this->getRequest()->getParam($name);

        if (null !== $requestValue) {
            $value = $requestValue;
        } else if ($parameter->isDefaultValueAvailable()) {
            $value = $parameter->getDefaultValue();
        } else {
            if (!$parameter->isOptional()) {
                throw new Your_Controller_Action_Exception(
                        sprintf("Missing required value for argument: '%s'", $name));
            }

            $value = null;
        }

        return $value;
    }

    /**
     *
     * @param mixed $value 
     */
    protected function _fixValueType($value, $type)
    {
        if (in_array($type, $this->_basicTypes)) {
            settype($value, $type);
        }

        return $value;
    }

    /**
     * Dispatch the requested action
     *
     * @param   string $action Method name of action
     * @return  void
     */
    public function dispatch($action)
    {
        $request = $this->getRequest();

        // Notify helpers of action preDispatch state
        $this->_helper->notifyPreDispatch();

        $this->preDispatch();
        if ($request->isDispatched()) {
            // preDispatch() didn't change the action, so we can continue
            if ($this->_hasAction($action)) {

                $requestArgs = array();
                $dependencyObjects = array();
                $requiredArgs = array();

                foreach ($this->_actionReflectionParams($action) as $parameter) {
                    $type = $this->_getParameterType($parameter);
                    $name = $parameter->getName();
                    $value = $this->_getParameterValue($parameter);

                    if (!in_array($type, $this->_basicTypes)) {
                        if (!is_object($value)) {
                            $value = new $type($value);
                        }
                        $dependencyObjects[$name] = $value;
                    } else {
                        $value = $this->_fixValueType($value, $type);
                        $requestArgs[$name] = $value;
                    }

                    if (!$parameter->isOptional()) {
                        $requiredArgs[$name] = $value;
                    }
                }

                // handle canonical URLs here

                $allArgs = array_merge($requestArgs, $dependencyObjects);
                // dispatch the action with arguments
                call_user_func_array(array($this, $action), $allArgs);
            } else {
                $this->__call($action, array());
            }
            $this->postDispatch();
        }

        $this->_helper->notifyPostDispatch();
    }

}

要使用它,只需:

Your_FineController extends Your_Controller_Action {}

并像往常一样为操作提供注释(至少您应该;)。

例如:

/**
 * @param int $id Mandatory parameter
 * @param string $sorting Not required parameter
 * @param Your_Model_Name $model Optional dependency object 
 */
public function indexAction($id, $sorting = null, Your_Model_Name $model = null) 
{
    // model has been already automatically instantiated if null
    $entry = $model->getOneById($id, $sorting);
}

(DocBlock是必需的,但是我使用Netbeans IDE,因此DocBlock是根据操作参数自动生成的)


答案 2

好吧,这就是我是如何做到的:

作为IoC框架,我使用了symfony框架的这个组件(但我没有下载最新版本,我使用了我以前在项目上使用的旧版本......请记住这一点!我在 下添加了它的类。/library/ioc/lib/

我在 my 中添加这些 init 函数是为了注册 IoC 框架的自动加载器:Bootstrap.php

protected function _initIocFrameworkAutoloader()
{
    require_once(APPLICATION_PATH . '/../library/Ioc/lib/sfServiceContainerAutoloader.php');

    sfServiceContainerAutoloader::register();
}

接下来,我做了一些设置,在其中设置连接xml的路径,并允许禁用自动依赖注入,例如在单元测试中:application.ini

ioc.controllers.wiringXml = APPLICATION_PATH "/objectconfiguration/controllers.xml"
ioc.controllers.enableIoc = 1

然后,我创建了一个自定义生成器类,该类扩展并将其放在 .在这个测试项目中,我把所有的类都放在.sfServiceContainerBuilder/library/MyStuff/Ioc/Builder.php/library/MyStuff/

class MyStuff_Ioc_Builder extends sfServiceContainerBuilder
{
  public function initializeServiceInstance($service)
  {
      $serviceClass = get_class($service);
      $definition = $this->getServiceDefinition($serviceClass);


    foreach ($definition->getMethodCalls() as $call)
    {
      call_user_func_array(array($service, $call[0]), $this->resolveServices($this->resolveValue($call[1])));
    }

    if ($callable = $definition->getConfigurator())
    {
      if (is_array($callable) && is_object($callable[0]) && $callable[0] instanceof sfServiceReference)
      {
        $callable[0] = $this->getService((string) $callable[0]);
      }
      elseif (is_array($callable))
      {
        $callable[0] = $this->resolveValue($callable[0]);
      }

      if (!is_callable($callable))
      {
        throw new InvalidArgumentException(sprintf('The configure callable for class "%s" is not a callable.', get_class($service)));
      }

      call_user_func($callable, $service);
    }

  }
}

最后,我创建了一个自定义控制器类,其中我的所有控制器都继承自:/library/MyStuff/Controller.php

class MyStuff_Controller extends Zend_Controller_Action {
    /**
     * @override
     */
    public function dispatch($action)
    {
        // NOTE: the application settings have to be saved 
        // in the registry with key "config"
        $config = Zend_Registry::get('config');

        if($config['ioc']['controllers']['enableIoc'])
        {
            $sc = new MyStuff_Ioc_Builder();

            $loader = new sfServiceContainerLoaderFileXml($sc);
            $loader->load($config['ioc']['controllers']['wiringXml']);

            $sc->initializeServiceInstance($this);
        }

        parent::dispatch($action);
    }
}

这基本上是使用IoC框架来初始化已经创建的控制器实例()。我所做的简单测试似乎做了我想做的事......让我们看看这在现实生活中的表现如何。;)$this

它仍然以某种方式进行猴子修补,但是Zend框架似乎没有提供一个钩子,我可以在其中使用自定义控制器工厂创建控制器实例,因此这是我想到的最好的...


推荐