萬盛學電腦網

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

Zend Framework 1 Filter 過濾器完整指南:基本過濾、過濾鏈與自訂過濾器實作

Zend Framework 1 的 Zend_Filter 元件提供資料過濾與轉換的標準化介面,支援單一過濾器、過濾鏈(管道模式)與自訂過濾器。本文涵蓋字串大小寫轉換、HTML 標籤移除、HTML 實體編碼、敏感詞過濾等實戰範例。

基本過濾器使用

<?php
require_once("Zend/Loader.php");
Zend_Loader::loadClass("Zend_Filter_StringToLower");
Zend_Loader::loadClass("Zend_Filter_StringToUpper");

$filterLower = new Zend_Filter_StringToLower();
$filterUpper = new Zend_Filter_StringToUpper();

$input = "ZHOUWUJIE   zhouwuji";
echo $filterLower->filter($input) . "<br>"; // zhouwujie   zhouwuji
echo $filterUpper->filter($input) . "<br>"; // ZHOUWUJIE   ZHOUWUJI
?>

過濾鏈:管道式多重過濾

Zend_Filter 類別本身即為過濾鏈容器,透過 addFilter() 串聯多個過濾器:

<?php
require_once("Zend/Loader.php");
Zend_Loader::loadClass("Zend_Filter");
Zend_Loader::loadClass("Zend_Filter_HtmlEntities");
Zend_Loader::loadClass("Zend_Filter_StripTags");

$filterChain = new Zend_Filter();
$filterChain->addFilter(new Zend_Filter_StripTags())      // 先移除 HTML 標籤
            ->addFilter(new Zend_Filter_HtmlEntities()); // 再轉換實體

$input = "<a href='#'>連結</a> <script>alert(1)</script>";
echo $filterChain->filter($input);
// 輸出:&lt;a href='#'&gt;連結&lt;/a&gt; &lt;script&gt;alert(1)&lt;/script&gt;
?>

常用內建過濾器速查

類別功能典型用途
Zend_Filter_StringToLower字串轉小寫正規化輸入
Zend_Filter_StringToUpper字串轉大寫代碼、代號標準化
Zend_Filter_StripTags移除 HTML/XML 標籤防 XSS、純文本輸入
Zend_Filter_HtmlEntities字元轉 HTML 實體安全輸出顯示
Zend_Filter_Digits只保留數字電話、身分證號
Zend_Filter_Alnum只保留英數字元用戶名、代碼
Zend_Filter_StringTrim去除首尾空白通用輸入清理
Zend_Filter_Null空字串轉 null資料庫儲存優化

自訂過濾器:敏感詞過濾範例

<?php
require_once("Zend/Loader.php");
Zend_Loader::loadClass("Zend_Filter_Interface");

class MyFilter implements Zend_Filter_Interface {
    protected $_badWords = array('黃色', '賭', '毒');

    public function filter($value) {
        foreach ($this->_badWords as $word) {
            $value = str_replace($word, '*', $value);
        }
        return $value;
    }
}

$filter = new MyFilter();
echo $filter->filter('這條信息是黃色內容') . "<br>"; // 這條信息是*內容
echo $filter->filter('他今天去賭博了') . "<br>";   // 他今天去*博了
echo $filter->filter('他今天去吸毒了') . "<br>";   // 他今天去吸*了
?>

進階:動態配置過濾鏈

<?php
// 從配置檔建構過濾鏈
$filterConfig = array(
    'filters' => array(
        array('name' => 'StringTrim'),
        array('name' => 'StripTags'),
        array('name' => 'HtmlEntities', 'options' => array('quotestyle' => ENT_QUOTES)),
        array('name' => 'MyFilter'),  // 自訂過濾器需先註冊自動載入
    )
);

$filterChain = new Zend_Filter();
foreach ($filterConfig['filters'] as $f) {
    $class = 'Zend_Filter_' . $f['name'];
    if (class_exists($class)) {
        $filterChain->addFilter(new $class($f['options'] ?? array()));
    }
}
?>

Filter vs Validator 差異

特性Filter (過濾器)Validator (驗證器)
目的轉換/清理資料檢查資料是否符合規則
回傳值轉換後的資料布林值(通過/失敗)
失敗處理不會失敗,盡力轉換回傳 false,提供錯誤訊息
典型流程輸入 → Filter → Validator → 業務邏輯

最佳實踐

  • 輸入端:Filter 先清理(Trim、StripTags),再 Validator 驗證
  • 輸出端:使用 HtmlEntities、Json 等編碼過濾器防 XSS
  • 自訂過濾器實作 Zend_Filter_Interface,單一職責,易測試
  • 避免在過濾器中執行副作用操作(寫 DB、發 API),保持純函數特性

Zend_Filter 以管道模式優雅解決資料轉換需求,配合內建豐富過濾器與簡單的自訂介面,是 ZF1 專案資料處理層的核心組件。

copyright © 萬盛學電腦網 all rights reserved