16.6. Zend_Filter_Inflector

变形器要求 target 和一个或多个 rules。 目标基本上是个字符串，它为你想替换的变量定义了占位符。 这些由带有':'的前缀来指定：:script。

当调用 filter() 时，传递一个和在目标中的变量相应的键/值对的数组。

在目标中的每个变量可以有零到多个规则。规则可以是 静态的 或指向 Zend_Filter 类的引用。 静态规则将用提供的文本替换，否则，和提供的规则匹配的类将用于变形这个文本。 类一般使用指示从任何普通前缀剥离的滤器名的短名来指定。

例如，你可以使用 Zend_Filter 的任何具体实现，然而，不用引用它们为 'Zend_Filter_Alpha' 或 'Zend_Filter_StringToLower'， 而是只指定 'Alpha' 或 'StringToLower'。

Zend_Filter_Inflector 使用 Zend_Loader_PluginLoader 来管理加载和变形一起使用的过滤器。 缺省地，任何带有 Zend_Filter 前缀的过滤器都可用。 为了访问带有那个前缀的过滤器，但发生在较深的等级结构里，如各种字过滤器，只需要剥离 Zend_Filter 前缀：

<?php
// use Zend_Filter_Word_CamelCaseToDash as a rule
$inflector->addRules(array('script' => 'Word_CamelCaseToDash'));
?>

要设置备用的路径，Zend_Filter_Inflector 有个实用方法 addFilterPrefixPath() 来代理插件加载器：

<?php
$inflector->addFilterPrefixPath('My_Filter', 'My/Filter/');
?>

另外，你可以从变形器获取插件加载器并和它直接互动：

<?php
$loader = $inflector->getPluginLoader();
$loader->addPrefixPath('My_Filter', 'My/Filter/');
?>

更多关于修改过滤器路径的选项，请参考 插件加载器文档 。

变形器目标是一个带有一些变量的占位符的字符串。 占位符表现为识别器的形式，缺省为冒号（':'），紧跟着变量名：':script'、 ':path'等。 filter() 方法寻找跟随着被替换的变量名的识别器。

可用使用 setTargetReplacementIdentifier() 方法来改变识别器，或把它当作第三个参数传递给构造器：

<?php
// Via constructor:
$inflector = new Zend_Filter_Inflector('#foo/#bar.#sfx', null, '#');

// Via accessor:
$inflector->setTargetReplacementIdentifier('#');
?>

一般地，通过构造器来设置目标。然而，你想在稍后重置目标（例如，在核心部件里修改缺省变形器，如 ViewRenderer 或 Zend_Layout ）， 可使用 setTarget() ：

<?php
$inflector = $layout->getInflector();
$inflector->setTarget('layouts/:script.phtml');
?>

另外，你可能希望在你的类中有类成员，类用来保持变形器目标是最新的 － 不需要每次直接更新目标 （这样节省调用方法）。setTargetReference() 让你来做这个：

<?php
class Foo
{
    /**
     * @var string Inflector target
     */
    protected $_target = 'foo/:bar/:baz.:suffix';

    /**
     * Constructor
     * @return void
     */
    public function __construct()
    {
        $this->_inflector = new Zend_Filter_Inflector();
        $this->_inflector->setTargetReference($this->_target);
    }

    /**
     * Set target; updates target in inflector
     * 
     * @param  string $target 
     * @return Foo
     */
    public function setTarget($target)
    {
        $this->_target = $target;
        return $this;
    }
}
?>

如在简介中所提到的，有两种类型的规则：静态的和基于过滤器的。

	注意
	不论你添加规则给变形器的方法是一个接着一个还是一下子全部，顺序很重要。 更具体的名字或可能包含其它规则名的名字必需在最不具体名之前添加。 例如，假定令各规则名 'moduleDir' 和 'module'，'moduleDir' 规则应当在 'module' 之前出现， 因为 'module' 包含在 'moduleDir' 中，如果 'module' 在 'moduleDir' 之前添加， 'module' 将匹配 'moduleDir' 的一部分并且处理它把 'Dir' 留在在未变形的目标里。

<?php
$inflector = new Zend_Filter_Inflector(':script.:suffix');
$inflector->setStaticRule('suffix', 'phtml');

// change it later:
$inflector->setStaticRule('suffix', 'php');
?>

<?php
class Foo
{
    /**
     * @var string Suffix
     */
    protected $_suffix = 'phtml';

    /**
     * Constructor
     * @return void
     */
    public function __construct()
    {
        $this->_inflector = new Zend_Filter_Inflector(':script.:suffix');
        $this->_inflector->setStaticRuleReference('suffix', $this->_suffix);
    }

    /**
     * Set suffix; updates suffix static rule in inflector
     * 
     * @param  string $suffix 
     * @return Foo
     */
    public function setSuffix($suffix)
    {
        $this->_suffix = $suffix;
        return $this;
    }
}
?>

<?php
$inflector = new Zend_Filter_Inflector(':script.:suffix');

// Set rule to use Zend_Filter_Word_CamelCaseToDash filter
$inflector->setFilterRule('script', 'Word_CamelCaseToDash');

// Add rule to lowercase string
$inflector->addFilterRule('script', new Zend_Filter_StringToLower());

// Set rules en-masse
$inflector->setFilterRule('script', array(
    'Word_CamelCaseToDash',
    new Zend_Filter_StringToLower()
));
?>

<?php
// Could also use setRules() with this notation:
$inflector->addRules(array(
    // filter rules:
    ':controller' => array('CamelCaseToUnderscore','StringToLower'),
    ':action'     => array('CamelCaseToUnderscore','StringToLower'),

    // Static rule:
    'suffix'      => 'phtml'
));
?>

Zend_Filter_Inflector 有很多实用方法用来读取和设置插件加载器、处理和读取规则以及当有异常抛出时的控制。

你可以通过传递 Zend_Config 对象给构造器或setConfig()来使用 Zend_Config 设置规则、过滤器前缀路径和其它在你的变形器里的对象。 可以指定下列设置：

<?php
// With the constructor:
$config    = new Zend_Config($options);
$inflector = new Zend_Filter_Inflector($config);

// Or with setConfig():
$inflector = new Zend_Filter_Inflector();
$inflector->setConfig($config);
?>