Zend Framework Filter 過濾器全攻略：內建過濾、過濾鏈與自定義過濾器實戰

Zend Framework 1.x 的 Zend_Filter 提供統一的資料過濾介面，支援字符串大小寫轉換、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   zhouwujie  ';
echo $filterLower->filter($input); // zhouwujie   zhouwujie
echo $filterUpper->filter($input); // ZHOUWUJIE   ZHOUWUJIE

場景二：過濾鏈組合多重處理

<?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())      // 1. 剝離 HTML 標籤
            ->addFilter(new Zend_Filter_Htmlentities());  // 2. 特殊字符轉實體

$html = "<a href='#'>鏈接</a>";
echo $filterChain->filter($html); // 輸出：<a href='#'>鏈接</a>（標籤被剝離，< > 被轉義）

場景三：自定義過濾器實作敏感詞過濾

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

class MyFilter implements Zend_Filter_Interface {
    public function filter($value) {
        $blacklist = ['黃色', '賭', '毒'];
        foreach ($blacklist as $word) {
            $value = str_replace($word, '*', $value);
        }
        return $value;
    }
}

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

核心類別與介面速查

過濾鏈執行機制

1. 順序執行：addFilter 順序即執行順序。
2. 管道流：上一個過濾器的輸出直接作為下一個的輸入。
3. 異常傳遞：任一過濾器拋出異常將中斷鏈，建議在過濾器內部捕獲並記錄。
4. 無狀態：內建過濾器均為無狀態，可安全複用實例。

最佳實踐建議

• 輸入端過濾：在 Controller 接收請求參數時，統一通過過濾鏈清洗（去標籤、轉實體、修剪空白）。
• 輸出端過濾：View 渲染前針對不同上下文（HTML、JS、URL）套用對應過濾器，防 XSS。
• 複用過濾鏈：將常用鏈封裝為 Service/Helper，如 HtmlPurifyFilterChain、SafeTextFilterChain。
• 效能：避免在循環中重複建立過濾鏈實例，靜態緩存或依賴注入容器管理。

善用 Zend_Filter 可建立清晰、可測試、可複用的資料清洗管道，是 ZF1 專案安全與健壯性的基石。