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);
// 輸出:<a href='#'>連結</a> <script>alert(1)</script>
?>
| 類別 | 功能 | 典型用途 |
|---|---|---|
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 (過濾器) | Validator (驗證器) |
|---|---|---|
| 目的 | 轉換/清理資料 | 檢查資料是否符合規則 |
| 回傳值 | 轉換後的資料 | 布林值(通過/失敗) |
| 失敗處理 | 不會失敗,盡力轉換 | 回傳 false,提供錯誤訊息 |
| 典型流程 | 輸入 → Filter → Validator → 業務邏輯 |
Filter 先清理(Trim、StripTags),再 Validator 驗證HtmlEntities、Json 等編碼過濾器防 XSSZend_Filter_Interface,單一職責,易測試Zend_Filter 以管道模式優雅解決資料轉換需求,配合內建豐富過濾器與簡單的自訂介面,是 ZF1 專案資料處理層的核心組件。