萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Zend Framework 1 驗證器完整教學:內建驗證器、自訂驗證器與驗證器鏈實戰

Zend Framework 1 的 Zend_Validate 元件提供標準化的資料驗證機制,支援鏈式組合多個驗證器。本文示範內建驗證器使用、實作自訂驗證器(實作 Zend_Validate_Interface)、以及驗證器鏈的建構與錯誤處理。

核心介面:Zend_Validate_Interface

自訂驗證器需實作兩個方法:

  • isValid($value):回傳布林值,失敗時填充 $_messages
  • getMessages():回傳錯誤訊息陣列

實作自訂驗證器:公倍數驗證

<?php
require_once("Zend/Loader.php");
Zend_Loader::loadClass('Zend_Validate');
Zend_Loader::loadClass('Zend_Validate_Int');
Zend_Loader::loadClass('Zend_Validate_Interface');

/** 驗證是否為 3 和 5 的公倍數 */
class GongBeiNum implements Zend_Validate_Interface {
    protected $_messages = array();

    public function isValid($num) {
        if (!($num % 3 == 0) && !($num % 5 == 0)) {
            $this->_messages[] = "輸入值不是 3 和 5 的公倍數!";
            return false;
        }
        return true;
    }

    public function getMessages() {
        return $this->_messages;
    }

    public function getErrors() {
        return array_keys($this->_messages);
    }
}
?>

建構驗證器鏈並執行驗證

<?php
function check_num($num) {
    $validator = new Zend_Validate();
    
    // 加入驗證器鏈:先驗證整數,再驗證公倍數
    $validator->addValidator(new Zend_Validate_Int())
              ->addValidator(new GongBeiNum());

    if (!$validator->isValid($num)) {
        foreach ($validator->getMessages() as $msg) {
            echo $msg . "<br>";
        }
        return false;
    }
    echo "驗證通過:$num 是 3 和 5 的公倍數整數<br>";
    return true;
}

// 測試
check_num('15');  // 通過
check_num('9');   // 失敗:非 5 的倍數
check_num('abc'); // 失敗:非整數
?>

常用內建驗證器速查

類別用途常用選項
Zend_Validate_Int整數驗證
Zend_Validate_EmailAddressEmail 格式允許 MX 檢查、IDN
Zend_Validate_StringLength字串長度min, max, encoding
Zend_Validate_Regex正則匹配pattern
Zend_Validate_InArray值在陣列中haystack, strict
Zend_Validate_Date日期格式format, locale
Zend_Validate_File_*檔案上傳驗證size, extension, mime

驗證器鏈執行邏輯

  • 依 addValidator() 順序執行
  • 任一驗證器失敗即停止後續驗證(預設)
  • 可用 addValidator($validator, true) 第二參數 true 表示「中斷鏈」,false 表示「繼續收集錯誤」
  • getMessages() 回傳所有失敗驗證器的錯誤訊息(扁平化陣列)
  • getErrors() 回傳錯誤代碼鍵值陣列

表單整合建議

<?php
// 在表單處理中使用
$filters = array('*' => 'StringTrim');
$validators = array(
    'email' => array(
        'EmailAddress',
        'presence' => 'required'
    ),
    'age' => array(
        array('Int', true),
        array('Between', true, array(18, 120))
    )
);

// 搭配 Zend_Filter_Input 批次處理
$input = new Zend_Filter_Input($filters, $validators, $_POST);
if ($input->isValid()) {
    // 處理有效資料
} else {
    $errors = $input->getMessages();
    // 顯示錯誤
}
?>

掌握驗證器鏈模式,能將驗證邏輯模組化、可重用,並統一錯誤處理流程,是建構健壯 PHP 應用的關鍵技能。

copyright © 萬盛學電腦網 all rights reserved