輸入驗證是 Web 安全的第一道防線。本文提供生產環境可用的 PHP 正則函式,涵蓋 Email、URL、手機號碼 (含中國大陸/台灣/國際)、身分證、統編等常見場景,並說明驗證策略與安全注意事項。
function isEmail(string $email): bool {
if (strlen($email) > 254) return false; // RFC 限制
$pattern = '/^[a-zA-Z0-9.!#$%&\'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$/u';
return (bool)preg_match($pattern, $email);
}
function isEmailStrict(string $email): bool {
if (!isEmail($email)) return false;
$domain = substr(strrchr($email, '@'), 1);
return checkdnsrr($domain, 'MX') || checkdnsrr($domain, 'A'); // 需 DNS 支援
}
注意:filter_var($email, FILTER_VALIDATE_EMAIL) 內建驗證較寬鬆,不支援國際化域名 (IDN),建議自行實作或用 egulias/email-validator 套件。
function isUrl(string $url): bool {
$pattern = '/^https?:\/\/' // 協議
. '(?:' // 主機
. '(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}' // 域名
. '|' // 或
. '(?:\d{1,3}\.){3}\d{1,3}' // IPv4
. ')'
. '(?::\d{1,5})?' // 埠
. '(?:\/[^\s?#]*)?' // 路徑
. '(?:\?[^\s#]*)?' // 查詢
. '(?:#[^\s]*)?' // 錨點
. '$/u';
return (bool)preg_match($pattern, $url);
}
function isUrlIdn(string $url): bool {
// 先用 idn_to_ascii 轉換 Unicode 域名
if (preg_match('/^https?:\/\/([^\/:@]+)(?::(\d+))?(.*)$/u', $url, $m)) {
$host = $m[1];
$port = $m[2] ?? '';
$rest = $m[3] ?? '';
$asciiHost = idn_to_ascii($host, IDNA_NONTRANSITIONAL_TO_ASCII, INTL_IDNA_VARIANT_UTS46);
if ($asciiHost === false) return false;
$asciiUrl = "https://{$asciiHost}" . ($port ? ":{$port}" : '') . $rest;
return isUrl($asciiUrl);
}
return false;
}
function isMobileCN(string $mobile): bool {
// 基礎版:快速檢查格式
if (!preg_match('/^1[3-9]\d{9}$/u', $mobile)) return false;
// 進階版:排除未啟用段 (參考工信號最新公告)
$validPrefixes = [
'13' => range(0,9), '14' => [5,6,7,8,9], '15' => [0,1,2,3,5,6,7,8,9],
'16' => [2,5,6,7], '17' => [0,1,2,3,4,5,6,7,8], '18' => range(0,9),
'19' => [1,3,5,8,9]
];
$prefix = substr($mobile, 0, 3);
$third = (int)$mobile[2];
foreach ($validPrefixes as $p => $arr) {
if (str_starts_with($prefix, $p) && in_array($third, $arr, true)) return true;
}
return false;
}
function isMobileTW(string $mobile): bool {
return (bool)preg_match('/^09\d{8}$/u', $mobile);
}
function isMobileInternational(string $mobile): bool {
// 允許 + 開頭,或 00 開頭,總長 8-15 位數字
return (bool)preg_match('/^(?:\+|00)[1-9]\d{6,14}$/u', $mobile);
}
| 類型 | 正則 | 說明 |
|---|---|---|
| 台灣身分證 | /^[A-Z][12]\d{8}$/u | 字母+性別碼+8數字 |
| 中國大陸身分證 (18位) | /^[1-9]\d{5}(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$/u | 含地址碼、出生日期、順序碼、校驗碼 |
| 統一編號 (台灣/中國) | /^\d{8}$/u / /^\d{9}$/u | 純數字,需另行演算法校驗 |
| IPv4 | /^(?:(?:25[0-5]|2[0-4]\d|[01]?\d?\d)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d?\d)$/u | |
| IPv6 (簡化) | /^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/u | 不支援 :: 壓縮,完整版極複雜建議用 filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) |
| 中文姓名 (2-10字) | /^[\x{4e00}-\x{9fa5}]{2,10}$/u | 僅中文字,排除生僻字可用 Unicode 區塊 |
| 郵遞區號 (台灣3+3 / 中國6位) | /^\d{3}(?:\d{3})?$/u | |
| 強密碼 (8-20位,含大小寫數字特殊符號) | /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,20}$/u | 正向預查 |
mb_strlen,防止 ReDoS 與緩衝區溢位。trim、mb_convert_kana (全半形轉換)、idn_to_ascii (IDN) 後再匹配。respect/validation - 鏈式語法、豐富規則、國際化支援illuminate/validation,規則豐富、錯誤訊息本地化正則驗證是「必要但不充分」的條件。將本文函式封裝為 Validator 類別,搭配框架驗證組件、資料庫唯一約束、業務規則引擎,才能構建完整的輸入防護體系。記住:驗證失敗時,回傳具體錯誤碼而非泛泛的「格式錯誤」,提升用戶體驗並降低客服成本。