萬盛學電腦網

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

PHP 日期時間驗證完全指南:checkdate、正則、DateTime 與業務場景最佳實踐

驗證用戶輸入的日期是否合法(如 2023-02-29 不存在、月份 13 不存在)是表單處理的基礎需求。PHP 提供內建 checkdate()、正則匹配、DateTime 物件解析三種方案,各有適用場景。本文系統對比並給出最佳實踐。

方案一:checkdate() —— 官方推薦的日曆合法性檢查

<?php
// bool checkdate(int $month, int $day, int $year)
// 參數順序:月、日、年(注意順序!)
var_dump(checkdate(12, 31, 2000)); // true
var_dump(checkdate(2, 29, 2003));  // false(2003 非閏年)
var_dump(checkdate(2, 29, 2004));  // true(2004 閏年)
var_dump(checkdate(13, 1, 2024));  // false(月份無效)
var_dump(checkdate(0, 1, 2024));   // false(月份無效)
?>

優點:原生函數、自動處理閏年/每月天數、無需正則、效能高。
缺點:需先將字串解析為年/月/日整數、不支援時間部分驗證。

方案二:正則表達式 —— 格式預檢查

<?php
// 僅驗證格式 YYYY-MM-DD,不驗證日期合法性(如 2023-02-30 會通過)
function isDateFormat(string $str): bool {
    return (bool)preg_match('/^\d{4}-\d{2}-\d{2}$/', $str);
}

// 驗證日期時間格式 YYYY-MM-DD HH:MM:SS
function isDateTimeFormat(string $str): bool {
    return (bool)preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $str);
}

// 帶範圍約束的正則(粗略)
function isDateRangeFormat(string $str): bool {
    // 月份 01-12,日期 01-31(不精確檢查每月天數)
    return (bool)preg_match('/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/', $str);
}
?>

適用場景:前端提交前預檢、API 參數格式校驗、日誌解析預過濾。

方案三:DateTime 物件解析 —— 最嚴格、功能最全

<?php
function validateDateTime(string $datetime, string $format = 'Y-m-d H:i:s'): bool {
    $dt = DateTime::createFromFormat($format, $datetime);
    // 必須檢查:無錯誤、且格式化後與原字串完全一致(防止溢出自動修正)
    return $dt !== false && $dt->format($format) === $datetime;
}

// 使用範例
var_dump(validateDateTime('2024-02-29 12:00:00')); // true(閏年)
var_dump(validateDateTime('2023-02-29 12:00:00')); // false
var_dump(validateDateTime('2024-13-01 12:00:00')); // false
var_dump(validateDateTime('2024-02-29 25:00:00')); // false(時段錯誤)
var_dump(validateDateTime('2024-02-29 12:60:00')); // false

// 僅驗證日期
function validateDate(string $date): bool {
    return validateDateTime($date . ' 00:00:00', 'Y-m-d H:i:s');
}
?>

關鍵技巧:$dt->format($format) === $datetime 確保「嚴格模式」,防止 DateTime 自動修正無效日期(如 2023-02-29 → 2023-03-01)。

綜合驗證函數(生產就緒)

<?php
class DateValidator {
    /** 驗證日期字串(支援多種常見格式) */
    public static function validate(string $input, ?string &$normalized = null): bool {
        $formats = [
            'Y-m-d',           // 2024-01-15
            'Y/m/d',           // 2024/01/15
            'Y.m.d',           // 2024.01.15
            'Y年m月d日',        // 2024年01月15日
            'Y-m-d H:i:s',     // 2024-01-15 14:30:00
            'Y/m/d H:i:s',
            'Y-m-d\TH:i:s',    // ISO 8601 無時區
            'Y-m-d\TH:i:sP',   // ISO 8601 帶時區
        ];
        
        foreach ($formats as $fmt) {
            $dt = DateTime::createFromFormat($fmt, $input);
            if ($dt !== false && $dt->format($fmt) === $input) {
                $normalized = $dt->format('Y-m-d H:i:s'); // 統一輸出格式
                return true;
            }
        }
        return false;
    }
    
    /** 快速驗證:僅 Y-m-d 格式 */
    public static function validateDate(string $date): bool {
        $parts = explode('-', $date);
        if (count($parts) !== 3) return false;
        return checkdate((int)$parts[1], (int)$parts[2], (int)$parts[0]);
    }
    
    /** 獲取日期錯誤詳情(用於用戶提示) */
    public static function getError(string $input): string {
        if (!preg_match('/^\d{4}[-\/.]\d{2}[-\/.]\d{2}/', $input)) {
            return '格式錯誤,請使用 YYYY-MM-DD';
        }
        $parts = explode('-', str_replace(['/','.'], '-', $input));
        $y = (int)$parts[0]; $m = (int)$parts[1]; $d = (int)$parts[2];
        if ($m < 1 || $m > 12) return '月份必須在 1-12 之間';
        if ($d < 1 || $d > 31) return '日期必須在 1-31 之間';
        if (!checkdate($m, $d, $y)) return "{$y}年{$m}月沒有{$d}日(閏年規則)";
        return '';
    }
}

// 使用
$input = '2024-02-29';
if (DateValidator::validate($input, $norm)) {
    echo "合法,標準化: $norm";
} else {
    echo "錯誤: " . DateValidator::getError($input);
}
?>

業務場景專項驗證

1. 年齡驗證(出生日期)

<?php
function validateBirthdate(string $birthdate, int $minAge = 18): bool {
    if (!DateValidator::validateDate($birthdate)) return false;
    $birth = new DateTime($birthdate);
    $now = new DateTime();
    $age = $now->diff($birth)->y;
    return $age >= $minAge;
}
?>

2. 日期範圍驗證(開始 ≤ 結束)

<?php
function validateDateRange(string $start, string $end): bool {
    if (!DateValidator::validate($start, $s) || !DateValidator::validate($end, $e)) return false;
    return $s <= $e;
}
?>

3. 未來/過去日期限制

<?php
function validateFutureDate(string $date): bool {
    if (!DateValidator::validateDate($date)) return false;
    return new DateTime($date) > new DateTime('today');
}

function validatePastDate(string $date): bool {
    if (!DateValidator::validateDate($date)) return false;
    return new DateTime($date) < new DateTime('today');
}
?>

方案對比總結

| 方案 | 驗證嚴格度 | 效能 | 適用場景 | |------|------------|------|----------| | checkdate() | 高(日曆級) | 極快 | 已解析年/月/日整數、僅需日期合法性 | | 正則格式檢查 | 低(僅格式) | 快 | 前端預檢、API 格式校驗、大批量預過濾 | | DateTime::createFromFormat | 最高(含時間、時區、嚴格模式) | 中等 | 表單提交最終驗證、多格式支援、需標準化輸出 |

最佳實踐建議

  1. 分層驗證:前端 HTML5 type="date" + JS 正則 → 後端 DateTime 嚴格驗證 + checkdate 快速路徑
  2. 統一標準化:驗證通過後統一轉為 Y-m-d 或 Y-m-d H:i:s 存入資料庫
  3. 時區一致性:驗證與存儲使用同一時區(建議 UTC 存儲,展示轉換)
  4. 錯誤信息友好:返回具體錯誤原因(如「2月沒有30日」而非「日期無效」)
  5. 避免 strtotime() 驗證:它會嘗試解析各種模糊格式,strtotime('2023-02-30') 返回 3 月 2 日的時間戳,極不安全

總結

PHP 日期驗證的「黃金組合」是:DateTime::createFromFormat 嚴格模式(格式化後比對原串)作為核心,checkdate() 作為純日期快速路徑,正則作為格式預檢。封裝為 DateValidator 工具類,統一項目日期處理標準,消除「2023-02-30 入庫」等低級 Bug。

copyright © 萬盛學電腦網 all rights reserved