| 函數 | 用途 |
filter_var($var, $filter, $options) | 單一變數過濾/驗證 |
filter_var_array($data, $filters) | 批次處理陣列 (如 $_POST) |
filter_input($type, $name, $filter) | 直接從輸入源 (GET/POST/COOKIE/SERVER/ENV) 取值並過濾 |
filter_list() | 列出所有可用過濾器 ID |
三大驗證器實戰
1. Email 驗證
<?php
$emails = [
'user@example.com',
'user.name+tag@sub.domain.org',
'invalid-email',
'user@localhost', // 技術上合法但實務少見
'user@[IPv6:2001:db8::1]', // IPv6 字面位址
];
foreach ($emails as $email) {
$result = filter_var($email, FILTER_VALIDATE_EMAIL);
echo $email . ' => ' . ($result ? '✅ 合法' : '❌ 不合法') . "
";
}
/*
輸出:
user@example.com => ✅ 合法
user.name+tag@sub.domain.org => ✅ 合法
invalid-email => ❌ 不合法
user@localhost => ✅ 合法 (RFC 5321 允許)
user@[IPv6:2001:db8::1] => ✅ 合法
*/
?>
選項:FILTER_FLAG_EMAIL_UNICODE (PHP 7.1+) 允許國際化郵件地址 (UTF-8 本地部)。
2. URL 驗證
<?php
$urls = [
'https://www.example.com/path?query=1#hash',
'https://localhost:8080',
'ftp://files.example.com',
'not-a-url',
'https://', // 不完整
];
foreach ($urls as $url) {
// FILTER_FLAG_SCHEME_REQUIRED / HOST_REQUIRED / PATH_REQUIRED / QUERY_REQUIRED
$result = filter_var($url, FILTER_VALIDATE_URL, FILTER_FLAG_SCHEME_REQUIRED | FILTER_FLAG_HOST_REQUIRED);
echo $url . ' => ' . ($result ? '✅' : '❌') . "
";
}
?>
注意:FILTER_VALIDATE_URL 依據 RFC 2396,對某些合法但罕見 URL 可能誤判。嚴格場景建議搭配 parse_url() 二次檢查。
3. IP 位址驗證
<?php
$ips = [
'192.168.1.1',
'255.255.255.255',
'256.1.1.1', // 無效
'::1', // IPv6 回環
'2001:0db8:85a3:0000:0000:8a2e:0370:7334',
'fe80::1%eth0', // 含區域索引
];
foreach ($ips as $ip) {
$v4 = filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
$v6 = filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
$any = filter_var($ip, FILTER_VALIDATE_IP);
echo "{$ip}: v4=" . ($v4 ? 'Y' : 'N') . " v6=" . ($v6 ? 'Y' : 'N') . " any=" . ($any ? 'Y' : 'N') . "
";
}
/* 旗標組合:
FILTER_FLAG_IPV4 / IPV6
FILTER_FLAG_NO_PRIV_RANGE (排除 10.x, 172.16-31.x, 192.168.x)
FILTER_FLAG_NO_RES_RANGE (排除保留/多播/回環)
*/
?>
進階:批次驗證表單輸入
<?php
$filters = [
'email' => FILTER_VALIDATE_EMAIL,
'age' => ['filter' => FILTER_VALIDATE_INT, 'options' => ['min_range' => 18, 'max_range' => 120]],
'price' => ['filter' => FILTER_VALIDATE_FLOAT, 'options' => ['decimal' => '.', 'min_range' => 0]],
'tags' => ['filter' => FILTER_DEFAULT, 'flags' => FILTER_REQUIRE_ARRAY], // 強制陣列
'website' => ['filter' => FILTER_VALIDATE_URL, 'flags' => FILTER_FLAG_SCHEME_REQUIRED],
];
$input = [
'email' => 'test@example.com',
'age' => '25',
'price' => '99.9',
'tags' => ['php', 'filter'],
'website' => 'https://example.com',
];
$result = filter_var_array($input, $filters);
/*
結果:
[
'email' => 'test@example.com',
'age' => 25, // 轉為 int
'price' => 99.9, // 轉為 float
'tags' => ['php', 'filter'],
'website' => 'https://example.com',
]
失敗欄位會是 false 或 null (視 FILTER_NULL_ON_FAILURE)
*/
?>
效能與維護優勢
- 零正則維護:內建驗證器由 PHP 核心團隊維護,符合 RFC 標準。
- C 層實作:比用戶空間 preg_match 快數倍。
- 可組合:
filter_var_array 一次驗證整個表單,程式碼乾淨。
- 資料清洗:
FILTER_SANITIZE_* 系列可移除/編碼危險字元 (如 FILTER_SANITIZE_SPECIAL_CHARS 防 XSS)。
善用 filter_var 系列,讓輸入驗證從「正則大雜燴」進化為「聲明式、可測試、標準化」的防禦第一道防線。
copyright ©
萬盛學電腦網 all rights reserved