Zend Framework 1 的 Zend_Validate 元件提供標準化的資料驗證機制,支援鏈式組合多個驗證器。本文示範內建驗證器使用、實作自訂驗證器(實作 Zend_Validate_Interface)、以及驗證器鏈的建構與錯誤處理。
自訂驗證器需實作兩個方法:
isValid($value):回傳布林值,失敗時填充 $_messagesgetMessages():回傳錯誤訊息陣列<?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_EmailAddress | Email 格式 | 允許 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 應用的關鍵技能。