# 過濾與清理（Filtering and Sanitizing） # 過濾與清理（Filtering and Sanitizing） 清理用戶輸入是軟件開發中很重要的一個環節。信任或者忽略對用戶輸入數據作清理可能會導致對應用內容（主要是用戶數據），甚至你應用所處在的服務器的非法訪問。  [Full image (from xkcd)](http://xkcd.com/327/) 此 [*Phalcon\\Filter*](#) 組件提供了一系列通用可用的過濾器和數據清理助手。它提供了圍繞于PHP過濾擴展的面向對象包裝。 ### 清理數據（Sanitizing data） 清理是指從一個值中移除特定字符的過程，此過程對用戶和應用不是必須，也不是他們想得到的。通過清理輸入，我們確保了應用的完整性和正確性。 ``` <pre class="calibre14">``` <?php use Phalcon\Filter; $filter = new Filter(); // 返回 "someone@example.com" $filter->sanitize("some(one)@exa\mple.com", "email"); // 返回 "hello" $filter->sanitize("hello<<", "string"); // 返回 "100019" $filter->sanitize("!100a019", "int"); // 返回 "100019.01" $filter->sanitize("!100a019.01a", "float"); ``` ``` ### 在控制器中使用清理（Sanitizing from Controllers） 當接收到GET或POST的數據時（通過請求對象），你可以在控制器中訪問一個 [*Phalcon\\Filter*](#) 對象。第一個參數是等待獲得變量的名字，第二個參數是將應用在此變量的過濾器。 ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Controller; class ProductsController extends Controller { public function indexAction() { } public function saveAction() { // 從輸入中清理price $price = $this->request->getPost("price", "double"); // 從輸入中清理email $email = $this->request->getPost("customerEmail", "email"); } } ``` ``` ### 過濾動作參數（Filtering Action Parameters） 接下來的示例演示了在一個控制器的動作中如何清理動作的參數： ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Controller; class ProductsController extends Controller { public function indexAction() { } public function showAction($productId) { $productId = $this->filter->sanitize($productId, "int"); } } ``` ``` ### 過濾數據（Filtering data） 此外， [*Phalcon\\Filter*](#) 也提供了可以進行刪除或者修改輸入數據以滿足我們需要的格式的過濾器。 ``` <pre class="calibre14">``` <?php use Phalcon\Filter; $filter = new Filter(); // 返回 "Hello" $filter->sanitize("<h1>Hello</h1>", "striptags"); // 返回 "Hello" $filter->sanitize(" Hello ", "trim"); ``` ``` ### 內置過濾器類型（Types of Built-in Filters） 以下是該容器提供的內置過濾器： ### 創建過濾器（Creating your own Filters） 你可以將你自己的過濾器添加到 [*Phalcon\\Filter*](#) 。過濾器的方法可以是匿名函數： ``` <pre class="calibre14">``` <?php use Phalcon\Filter; $filter = new Filter(); // 使用匿名函數 $filter->add('md5', function ($value) { return preg_replace('/[^0-9a-f]/', '', $value); }); // 利用md5過濾器清理 $filtered = $filter->sanitize($possibleMd5, "md5"); ``` ``` 或者，如果你愿意，你可以在類中實現過濾器： ``` <pre class="calibre14">``` <?php use Phalcon\Filter; class IPv4Filter { public function filter($value) { return filter_var($value, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4); } } $filter = new Filter(); // 使用對象 $filter->add('ipv4', new IPv4Filter()); // 利用"ipv4"過濾器清理 $filteredIp = $filter->sanitize("127.0.0.1", "ipv4"); ``` ``` ### 復雜的過濾與清理（Complex Sanitizing and Filtering） 你可以使用PHP本身提供的優秀過濾器擴展。請查看對應的文檔： [PHP文檔上的數據過濾器](http://www.php.net/manual/en/book.filter.php) ### 自定義過濾器（Implementing your own Filter） 如需創建你自己的過濾器并代替Phalcon提供的過濾器，你需要實現 [*Phalcon\\FilterInterface*](#) 接口。 | - [索引](# "總目錄") - [下一頁](# "上下文編碼（Contextual Escaping）") | - [上一頁](# "使用 Session 存儲數據（Storing data in Session）") |