Zend_Validate_InArray 用於驗證輸入值是否存在於指定陣列中,是表單選項、下拉選單、枚舉值驗證的常用工具。本文示範基本用法、嚴格模式、多維陣列搜尋與自訂錯誤訊息。
<?php
require_once("Zend/Loader.php");
Zend_Loader::loadClass("Zend_Validate");
Zend_Loader::loadClass("Zend_Validate_InArray");
$allowed = array('張三', '李四', '王五', '趙六', '田七');
$validator = new Zend_Validate_InArray($allowed);
$testValues = array('張三', '李四', '陌生人');
foreach ($testValues as $val) {
if ($validator->isValid($val)) {
echo "✅ [$val] 存在於允許清單<br>";
} else {
echo "❌ [$val] 不在允許清單:";
print_r($validator->getMessages());
echo "<br>";
}
}
?>
<?php
$haystack = array(1, '2', 3.0, 'test');
// 非嚴格模式(預設):'2' == 2 為 true
$v1 = new Zend_Validate_InArray($haystack);
var_dump($v1->isValid(2)); // true
var_dump($v1->isValid('2')); // true
var_dump($v1->isValid('3')); // true (字串 '3' == 3.0)
// 嚴格模式:=== 比較
$v2 = new Zend_Validate_InArray($haystack, true);
var_dump($v2->isValid(2)); // true
var_dump($v2->isValid('2')); // false (字串 !== 整數)
var_dump($v2->isValid('3')); // false (字串 !== 浮點數)
var_dump($v2->isValid('test')); // true
?>
<?php
$multi = array(
'fruits' => array('apple', 'banana', 'orange'),
'colors' => array('red', 'green', 'blue'),
'numbers' => array(1, 2, 3)
);
// 第三參數 true 啟用遞迴搜尋
$validator = new Zend_Validate_InArray($multi, true, true);
var_dump($validator->isValid('apple')); // true
var_dump($validator->isValid('red')); // true
var_dump($validator->isValid(2)); // true
var_dump($validator->isValid('purple')); // false
?>
<?php
$validator = new Zend_Validate_InArray(
array('admin', 'editor', 'viewer'),
true, // strict
false // recursive
);
// 設定自訂訊息模板
$validator->setMessage(
"角色 '%value%' 無效,允許角色:%array%",
Zend_Validate_InArray::NOT_IN_ARRAY
);
// 驗證失敗時會顯示自訂訊息
$validator->isValid('guest');
// 錯誤:角色 'guest' 無效,允許角色:admin, editor, viewer
?>
Zend_Validate_InArray::NOT_IN_ARRAY:值不在陣列中Zend_Validate_InArray::NOT_IN_ARRAY_STRICT:嚴格模式下不匹配<?php
$filters = array('role' => 'StringTrim');
$validators = array(
'role' => array(
array('InArray', true, array(
'haystack' => array('admin', 'editor', 'viewer'),
'strict' => true
)),
'presence' => 'required',
'messages' => array(
Zend_Validate_InArray::NOT_IN_ARRAY => '請選擇有效角色'
)
)
);
$input = new Zend_Filter_Input($filters, $validators, $_POST);
if ($input->isValid()) {
$role = $input->getEscaped('role');
// 處理有效角色
}
?>
isset($lookup[$value]) 查找,將陣列轉為鍵值查找表Zend_Validate_InArray 實例化為服務單例重用Zend_Validate_InArray 以宣告式語法簡化枚舉值驗證,配合嚴格模式與遞迴搜尋,滿足多數業務場景的白名單驗證需求。