萬盛學電腦網

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

PHP filter_var 內建過濾器驗證 Email、URL、IP、整數、浮點數完整指南

為何選擇 filter_var?

  • **內建 C 實作**,無需自寫正則,效能高、維護少。
  • **標準化**:遵循 RFC 5322 (Email)、RFC 3986 (URL)、IPv4/IPv6 標準。
  • **可擴充**:`FILTER_VALIDATE_*` 驗證、`FILTER_SANITIZE_*` 淨化、`FILTER_CALLBACK` 自訂。

常用驗證範例

1. Email 驗證

$email = 'user@example.com';
$result = filter_var($email, FILTER_VALIDATE_EMAIL);
var_dump($result); // string(16) "user@example.com" (通過回傳原值)
// 失敗回傳 false

⚠️ 注意:`FILTER_VALIDATE_EMAIL` **不支援** 國際化域名 (IDN, 如 `用戶@例子.中國`)、註解、引號內含特殊字元等完整 RFC 5322 邊緣案例。嚴格需求請用 `egulias/email-validator`。

2. URL 驗證

$url = 'https://www.example.com/path?query=1#hash';
$result = filter_var($url, FILTER_VALIDATE_URL);
var_dump($result); // string(...) "https://www.example.com/path?query=1#hash"

// 要求 scheme+host
$result = filter_var($url, FILTER_VALIDATE_URL, FILTER_FLAG_SCHEME_REQUIRED | FILTER_FLAG_HOST_REQUIRED);

3. IP 位址驗證 (IPv4 / IPv6)

$ipv4 = '192.168.1.110';
var_dump(filter_var($ipv4, FILTER_VALIDATE_IP)); // string(13) "192.168.1.110"

$ipv6 = '2001:DB8:2de::e13';
var_dump(filter_var($ipv6, FILTER_VALIDATE_IP)); // string(17) "2001:DB8:2de::e13"

// 限定 IPv4/IPv6
filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);

// 禁止私有/保留網段
filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE);

4. 整數驗證 + 範圍限制

$input = '010'; // 字串 "010"
$result = filter_var($input, FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1, 'max_range' => 100]
]);
var_dump($result); // bool(false) 因 "010" 視為八進位 8?實測 PHP 8 視為 10 但字串含前導零可能拒絕,建議先 trim/ltrim

// 正確用法:確保純數字字串
$input = '10';
$result = filter_var($input, FILTER_VALIDATE_INT, ['options' => ['min_range'=>1, 'max_range'=>100]]);
var_dump($result); // int(10)

**關鍵差異**:`filter_var` 嚴格型別檢查,`$input >= 1 && $input <= 100` 會因弱型別轉換導致 `'010'` 通過 (視為 10) 或 `'10abc'` 通過 (視為 10),**過濾器更嚴謹**。

5. 浮點數驗證

$float = '12.312';
$result = filter_var($float, FILTER_VALIDATE_FLOAT);
var_dump($result); // float(12.312)

// 允許千分位分隔符
filter_var('12,312.50', FILTER_VALIDATE_FLOAT, FILTER_FLAG_ALLOW_THOUSAND); // float(12312.5)

// 科學記號
filter_var('1.2e3', FILTER_VALIDATE_FLOAT); // float(1200)

進階:自訂過濾器 (FILTER_CALLBACK)

<?php
// 驗證手機號 (台灣格式)
$mobile = '0912345678';
$result = filter_var($mobile, FILTER_CALLBACK, [
    'options' => function($v) {
        return preg_match('/^09\d{8}$/', $v) ? $v : false;
    }
]);
var_dump($result); // string(10) "0912345678" 或 false

// 淨化 HTML 輸出
$dirty = 'Bold';
$clean = filter_var($dirty, FILTER_SANITIZE_SPECIAL_CHARS); // 實體化 < > & " '
echo $clean; // <script>alert(1)</script><b>Bold</b>

完整過濾器常數速查

分類常數說明
驗證FILTER_VALIDATE_BOOLEANtrue/false/1/0/yes/no/on/off
FILTER_VALIDATE_EMAILEmail 格式
FILTER_VALIDATE_FLOAT浮點數
FILTER_VALIDATE_INT整數 (可加 min/max_range)
FILTER_VALIDATE_IPIPv4/IPv6 (可加 FLAG)
FILTER_VALIDATE_MACMAC 位址 (PHP 7.2+)
FILTER_VALIDATE_REGEXP自訂正則 (options.regexp)
FILTER_VALIDATE_URLURL (可加 SCHEME/Host/PORT/QUERY FLAG)
淨化FILTER_SANITIZE_EMAIL移除非法字元
FILTER_SANITIZE_URL移除非法字元
FILTER_SANITIZE_NUMBER_INT保留數字、正負號
FILTER_SANITIZE_NUMBER_FLOAT保留數字、小數點、e、正負號
FILTER_SANITIZE_SPECIAL_CHARSHTML 實體化 (預設)
FILTER_SANITIZE_FULL_SPECIAL_CHARS等同 htmlspecialchars ENT_QUOTES

filter_input / filter_input_array:直接從超全域變數取值並驗證

// GET 參數驗證
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT, ['options'=>['min_range'=>1]]);
$keyword = filter_input(INPUT_GET, 'q', FILTER_SANITIZE_SPECIAL_CHARS);

// POST 批次
$args = [
    'email' => ['filter' => FILTER_VALIDATE_EMAIL],
    'age'   => ['filter' => FILTER_VALIDATE_INT, 'options' => ['min_range'=>18, 'max_range'=>120]],
    'bio'   => ['filter' => FILTER_SANITIZE_SPECIAL_CHARS],
];
$data = filter_input_array(INPUT_POST, $args);
// $data = ['email'=>'a@b.com', 'age'=>25, 'bio'=>'safe text'] 或 false/NULL

總結

`filter_var` / `filter_input*` 提供 **標準化、高效能、可讀性佳** 的資料驗證與淨化工具箱。Email/URL/IP/Int/Float 驗證**首選內建過濾器**;複雜業務規則用 `FILTER_CALLBACK` 封裝;**永遠記得:驗證 ≠ 輸出編碼**,輸出端仍需 `htmlspecialchars`/`json_encode` 等上下文編碼。

copyright © 萬盛學電腦網 all rights reserved