萬盛學電腦網

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

PHP filter_var 內建驗證器:Email、URL、IP 一鍵通關

拋棄手寫正則:用 filter_var 內建驗證 Email、URL、IP

PHP 5.2+ 內建 filter_var() 搭配驗證過濾器,提供標準化、無需維護正則的資料驗證。本文介紹常用驗證器、選項參數、自定義過濾鏈與效能優勢。

核心函數速查

三大驗證器實戰

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
函數用途
filter_var($var, $filter, $options)單一變數過濾/驗證
filter_var_array($data, $filters)批次處理陣列 (如 $_POST)
filter_input($type, $name, $filter)直接從輸入源 (GET/POST/COOKIE/SERVER/ENV) 取值並過濾
filter_list()列出所有可用過濾器 ID