萬盛學電腦網

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

Zend Framework 1 InArray 驗證器:陣列值存在性檢查完整範例

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');
    // 處理有效角色
}
?>

效能提示

  • 大型陣列(>1000 元素)建議改用 isset($lookup[$value]) 查找,將陣列轉為鍵值查找表
  • 頻繁驗證同一陣列時,將 Zend_Validate_InArray 實例化為服務單例重用
  • 遞迴搜尋會遍歷所有巢狀層級,大型多維陣列效能較差

Zend_Validate_InArray 以宣告式語法簡化枚舉值驗證,配合嚴格模式與遞迴搜尋,滿足多數業務場景的白名單驗證需求。

copyright © 萬盛學電腦網 all rights reserved