$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`。
$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);
$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);
$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),**過濾器更嚴謹**。
$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)
<?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_BOOLEAN | true/false/1/0/yes/no/on/off |
| FILTER_VALIDATE_EMAIL | Email 格式 | |
| FILTER_VALIDATE_FLOAT | 浮點數 | |
| FILTER_VALIDATE_INT | 整數 (可加 min/max_range) | |
| FILTER_VALIDATE_IP | IPv4/IPv6 (可加 FLAG) | |
| FILTER_VALIDATE_MAC | MAC 位址 (PHP 7.2+) | |
| FILTER_VALIDATE_REGEXP | 自訂正則 (options.regexp) | |
| FILTER_VALIDATE_URL | URL (可加 SCHEME/Host/PORT/QUERY FLAG) | |
| 淨化 | FILTER_SANITIZE_EMAIL | 移除非法字元 |
| FILTER_SANITIZE_URL | 移除非法字元 | |
| FILTER_SANITIZE_NUMBER_INT | 保留數字、正負號 | |
| FILTER_SANITIZE_NUMBER_FLOAT | 保留數字、小數點、e、正負號 | |
| FILTER_SANITIZE_SPECIAL_CHARS | HTML 實體化 (預設) | |
| FILTER_SANITIZE_FULL_SPECIAL_CHARS | 等同 htmlspecialchars ENT_QUOTES |
// 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` 等上下文編碼。