51.4. 编写校验器

尽管提供了一组通用的校验器,但不可避免地,开发者还将为他们特定的需求来编写定制的校验器。编写定制的校验器的任务将在本节描述。

Zend_Validate_Interface 定义了三个方法,isValid()getMessages()getErrors(), 为了创建校验对象,它们可以在用户的类里被实现。实现Zend_Validate_Interface接口的对象可以用Zend_Validate::addValidator() 添加到校验链里。这样的对象也可以和Zend_Filter_Input一起使用。

也许你已经从上面关于 的描述中推断出,不论一个值是否被校验成功,校验类为Zend Framework返回一个布尔值。它们也提供关于why一个值校验失败的信息。校验失败原因的有效性对于不同用途的应用程序可能很有价值,象为可用性分析提供的统计量。

基本校验失败消息的功能在Zend_Validate_Abstract中实现。当创建一个校验类,简单地扩展Zend_Validate_Abstract来包括这个功能。在扩展类里你将实现isValid() 方法逻辑和定义消息变量和消息模板,它和可能发生的校验失败类型相对应。如果校验测试一个值失败,isValid() 应该返回 false。如果这个值通过校验测试,isValid() 应该返回 true

一般地,isValid()方法不应该抛出任何异常,除了不可能决定输入值是否有效。一些抛出异常的合情合理的例子可能是如果文件不能被打开,LDAP服务器不能被联系,或者数据库连接无效,并且有些事情必须由校验成功或失败来决定。

例 51.1. 创建简单校验类

下面的例子演示如何编写一个非常简单的定制的校验器。在这个例子中,校验规则简单,输入值必须是浮点数值。

class MyValid_Float extends Zend_Validate_Abstract
{
    const FLOAT = 'float';

    protected $_messageTemplates = array(
        self::FLOAT => "'%value%' is not a floating point value"
    );

    public function isValid($value)
    {
        $this->_setValue($value);

        if (!is_float($value)) {
            $this->_error();
            return false;
        }

        return true;
    }
}

            

这个类为它的单个校验失败消息定义了一个模板,它包括内置的魔术参数,%value%。如果校验失败,对_setValue()的调用准备了自动插入被测试的值到失败消息的对象。对_error()的调用跟踪校验失败的原因。因为这个类只定义了一个失败消息,没有必要为_error()提供带有失败消息名字的模板。


例 51.2. 编写有独立条件的校验类

下面的例子演示一组稍微复杂的校验规则,要求输入值是数字并有最小值和最大值的范围。由于下面确切的原因之一,输入值校验失败:

  • 输入值不是数字。

  • 输入值小于允许的最小值。

  • 输入值大于允许的最大值。

这些校验失败的原因被翻译为在类中的定义:

class MyValid_NumericBetween extends Zend_Validate_Abstract
{
    const MSG_NUMERIC = 'msgNumeric';
    const MSG_MINIMUM = 'msgMinimum';
    const MSG_MAXIMUM = 'msgMaximum';

    public $minimum = 0;
    public $maximum = 100;

    protected $_messageVariables = array(
        'min' => 'minimum',
        'max' => 'maximum'
    );

    protected $_messageTemplates = array(
        self::MSG_NUMERIC => "'%value%' is not numeric",
        self::MSG_MINIMUM => "'%value%' must be at least '%min%'",
        self::MSG_MAXIMUM => "'%value%' must be no more than '%max%'"
    );

    public function isValid($value)
    {
        $this->_setValue($value);

        if (!is_numeric($value)) {
            $this->_error(self::MSG_NUMERIC);
            return false;
        }

        if ($value < $this->minimum) {
            $this->_error(self::MSG_MINIMUM);
            return false;
        }

        if ($value > $this->maximum) {
            $this->_error(self::MSG_MAXIMUM);
            return false;
        }

        return true;
    }
}

            

Public 属性$minimum$maximum 分别为成功校验一个值被建立用来提供最小和最大值边界。这个类也定义了两个消息变量和public属性相对应并允许minmaxvalue 一起被用在作为魔术参数的消息模板,

注意如果任何在isValid()中的校验检查失败,一个恰当的失败消息被准备,并且方法立即返回false。这些校验规则因此继续独立。换句话说,如果一个测试失败,不需要测试任何后来的校验规则。然而这本来不是个案例。下面的例子示例如何编写带有独立校验规则的类,校验对象返回什么校验企图失败的。


例 51.3. 带有独立条件、多重失败原因的校验

考虑编写一个为密码加强强度的校验类-当用户被要求为帮助使用户账户安全而选择符合一定条件的密码。让我们假设口令安全条件加强那个密码:

  • 至少8个字符长,

  • 包括至少一个大写字母,

  • 包括至少一个小写字母,

  • 并至少包括一个数字字符。

下面的类实现这些校验条件:

class MyValid_PasswordStrength extends Zend_Validate_Abstract
{
    const LENGTH = 'length';
    const UPPER  = 'upper';
    const LOWER  = 'lower';
    const DIGIT  = 'digit';

    protected $_messageTemplates = array(
        self::LENGTH => "'%value%' must be at least 8 characters in length",
        self::UPPER  => "'%value%' must contain at least one uppercase letter",
        self::LOWER  => "'%value%' must contain at least one lowercase letter",
        self::DIGIT  => "'%value%' must contain at least one digit character"
    );

    public function isValid($value)
    {
        $this->_setValue($value);

        $isValid = true;

        if (strlen($value) < 8) {
            $this->_error(self::LENGTH);
            $isValid = false;
        }

        if (!preg_match('/[A-Z]/', $value)) {
            $this->_error(self::UPPER);
            $isValid = false;
        }

        if (!preg_match('/[a-z]/', $value)) {
            $this->_error(self::LOWER);
            $isValid = false;
        }

        if (!preg_match('/\d/', $value)) {
            $this->_error(self::DIGIT);
            $isValid = false;
        }

        return $isValid;
    }
}

            

注意在isValid()中的四个条件测试不立即返回false。这允许校验类提供所有的输入的密码不符合要求的原因。如果例如一个用户打算输入"#$%"字符串作为密码,isValid()将导致所有四个校验失败消息被后来的getMessages()调用返回。