Zend_Form：addElementPrefixPath 与 addPrefixPath

Question

我目前正在使用 Zend_Form 构建自己的一组表单元素，并希望自定义表单中的所有元素都能够使用我的自定义装饰器，

因此我创建了一个如下所示的自定义表单：

<?php
class Nuke_Form extends Zend_Form
{

    public function __construct($options = null)
    {
        $this->addElementPrefixPath('Nuke_Form_Decorator_TwitterBootstrap', 'Nuke/Form/Decorator/TwitterBootstrap/', 'decorator');

        parent::__construct($options);

    }

}

为了完整起见，这是我的装饰器

<?php
class Nuke_Form_Decorator_TwitterBootstrap_ControlGroup extends Zend_Form_Decorator_Abstract
{

    public function render($content)
    {
        $class = $this->getOption('class') ?: "control-group";

        $element = $this->getElement();
        $errors = $element->getMessages();
        if (!empty($errors)) {
            $class .= " error";
        }

        $output = '<div class="' . $class . '">' . $content . '</div>';

        return $output;
    }

}

以及我在控制器中创建的具体表单实现

class App_Form_Index_Test extends Nuke_Form
{
    public function init()
    {
        parent::init();

        $this->addAttribs(array('class' => 'form-horizontal'));

        $username = new Nuke_Form_Element_Text('username');
        $username->setLabel("Gebruikersnaam")
                 ->setDescription("This is a description")
                 ->setRequired(true)
                 ->addValidator('NotEmpty', true)
                 ->addValidator('int');

        $submit = new Zend_Form_Element_Submit('submit');

        $this->addElements(array($username, $submit));
    }
}

，但由于某种原因，元素无法找到装饰器并输出以下异常：

Message: Plugin by name 'ControlGroup' was not found in the registry; used paths: Zend_Form_Decorator_: Zend/Form/Decorator/

分析异常，我看到我的插件路径未添加，即使我已明确添加它通过使用Nuke_Form 类中的 addElementPrefixPath()。

---

奇怪的是，当我将 PluginPath 单独添加到每个自定义元素时，它工作完美，如下所示。

<?php
class Nuke_Form_Element_Text extends Zend_Form_Element_Text
{
    public function init()
    {
        $this->addPrefixPath('Nuke_Form_Decorator_TwitterBootstrap', 'Nuke/Form/Decorator/TwitterBootstrap/', 'decorator');

        $this->addDecorators(array(
            array('ViewHelper', array(
                'helper' => 'formText'
            )),
            array('Errors'),
            array('Description', array(
                'placement' => Zend_Form_Decorator_Abstract::APPEND,
                'class' => 'help-block'
            )),
            array(array('controls' => 'HtmlTag'), array(
                'tag'   => 'div',
                'class' => 'controls',
            )),
            array('Label', array(
                'class' => 'control-label',
                'requiredSuffix' => ' *',
                'placement' => Zend_Form_Decorator_Abstract::PREPEND
            )),
            array('ControlGroup')
        ));
    }
}

---

我正在使用最新版本的 Zend Framework (v1.11.11)。

经过一些研究，我注意到 addElementPrefixPath() 会在调用时添加所有添加的表单元素的路径，我认为这就是为什么在 Nuke_Form 构造函数中调用它时它不起作用，因为当时尚未添加任何元素。但是我们应该如何使用这个方法呢？我在网上找到了几个在构造函数中成功调用它的示例。我感到困惑或忽略了某些事情。

Answer 1

尝试将其传递到构造函数中：
$options = array('elementPrefixPath' => 'Nuke/Form/Decorator/TwitterBootstrap/');

或者将其放入 init() 中：

public function __construct($options = null)
{
    parent::__construct($options);

}
public function init() {
    $this->addElementPrefixPath('Nuke_Form_Decorator_TwitterBootstrap_', 'Nuke/Form/Decorator/TwitterBootstrap/', 'decorator');
}

}

我认为在 init() 中调用它效果最好。并且不必费心在这里调用 parent::init(); ，它只是 Zend_Form 中的一个空函数，无需重写。

这确实有效

我使用了除自定义元素之外的所有代码，我在 inti() 中设置了 elementPrefixPath 并使用 addDecorator() 针对普通 Zend_Form_Element 调用了 ControlGroup Decorator，这是输出：

<form enctype="application/x-www-form-urlencoded" class="form-horizontal" method="post" action=""><dl class="zend_form">
<div class="control-group"><dt id="username-label"><label for="username" class="required">Gebruikersnaam</label></dt>
<dd id="username-element">
<input type="text" name="username" id="username" value="" />
<p class="description">This is a description</p></dd></div>
<dt id="submit-label"> </dt><dd id="submit-element">
<input type="submit" name="submit" id="submit" value="submit" /></dd></dl></form>

我所做的唯一更改是在前缀中添加尾随 _。

<?php
class Application_Form_NukeForm extends Zend_Form
{

    public function __construct($options = null)
    {

        parent::__construct($options);

    }
    public function init(){
        $this->addElementPrefixPath('Jgs_Decorator_', '/Jgs/Decorator/', 'decorator');
    }

}

当然，我使用了自己的路径...

<?php
class Application_Form_Test extends Application_Form_NukeForm
{
    public function init()
    {
        parent::init();

        $this->addAttribs(array('class' => 'form-horizontal'));

        $username = new Zend_Form_Element_Text('username');
        $username->setLabel("Gebruikersnaam")
                 ->setDescription("This is a description")
                 ->setRequired(true)
                 ->addValidator('NotEmpty', true)
                 ->addValidator('int')
                ->addDecorator('ControlGroup');

        $submit = new Zend_Form_Element_Submit('submit');

        $this->addElements(array($username, $submit));
    }
}

我只是重命名了装饰器以适合我的路径

<?php
class Jgs_Decorator_ControlGroup extends Zend_Form_Decorator_Abstract
{

    public function render($content)
    {
        $class = $this->getOption('class') ?: "control-group";

        $element = $this->getElement();
        $errors = $element->getMessages();
        if (!empty($errors)) {
            $class .= " error";
        }

        $output = '<div class="' . $class . '">' . $content . '</div>';

        return $output;
    }

}

我认为你的问题在其他地方...
我还让 __constructor 工作，我必须调整参数才能获得正确的选项：

<?php

class Application_Form_NukeForm extends Zend_Form {

    public function __construct($options = array('elementPrefixPath' => array(
            'prefix' => 'Jgs_',
            'path' => '/Jgs/',
            'type' => 'decorator'
    ))) {

        parent::__construct($options);
    }

我真的希望这有帮助:)

Answer 2

在 class Nuke_Form_Element_Text 中，如果调用 setDecorators() 而不是 addDecorators() 可能会更好，因为看起来好像要替换所有默认装饰器。
您也可以只添加 <代码>$this->loadDefaultDecoratorsIsDisabled();