萬盛學電腦網

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

PHP 日期時間格式驗證:正則表達式與內置函數最佳實踐

PHP 日期時間驗證:從正則到內置函數的最優方案

日期時間格式驗證是表單處理、API 參數校驗的高頻需求。本文分析正則表達式局限性,推薦結合 DateTime 類與 strtotime() 的現代最佳實踐。

一、正則表達式方案(不推薦用於完整驗證)

1. 簡單格式匹配

<?php
$dateTime = '2024-01-15 14:30:45';

// 僅匹配格式,不驗證邏輯合法性(如 2024-02-30 會通過)
if (preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $dateTime)) {
    echo "格式匹配";
}
// 缺陷:2024-13-45 99:99:99 也會通過
?>

2. 複雜正則嘗試驗證邏輯(極難維護)

<?php
// 這類正則極其複雜、難讀、易錯、性能差
$regex = '/^
    (?:
        (?P\d{4})-(?P0[1-9]|1[0-2])-(?P0[1-9]|[12]\d|3[01])
    )
    \s+
    (?:
        (?P[01]\d|2[0-3]):(?P[0-5]\d):(?P[0-5]\d)
    )
$/x';

// 即使匹配成功,仍無法驗證:2月30日、閏年2月29日等邏輯
// 結論:不要用正則驗證日期邏輯合法性
?>

二、現代最佳實踐:DateTime 類(推薦)

1. DateTime::createFromFormat() - 精確格式解析

<?php
function validateDateTime(string $dateTime, string $format = 'Y-m-d H:i:s'): bool {
    $dt = DateTime::createFromFormat($format, $dateTime);
    // 關鍵:檢查解析錯誤 且 格式化後與原輸入一致(防止溢出自動修正)
    $errors = DateTime::getLastErrors();
    return $dt !== false && $errors['warning_count'] === 0 && $errors['error_count'] === 0 
        && $dt->format($format) === $dateTime;
}

// 測試
var_dump(validateDateTime('2024-01-15 14:30:45')); // true
var_dump(validateDateTime('2024-02-30 14:30:45')); // false(2月無30日)
var_dump(validateDateTime('2024-13-01 14:30:45')); // false(無13月)
var_dump(validateDateTime('2024-01-15 25:30:45')); // false(無25時)
var_dump(validateDateTime('2024-01-15 14:60:45')); // false(無60分)
var_dump(validateDateTime('2024-01-15'));          // false(格式不匹配)

// 支持多種格式
function validateFlexible(string $input): ?DateTime {
    $formats = [
        'Y-m-d H:i:s',
        'Y-m-d',
        'Y/m/d H:i:s',
        'Y/m/d',
        'd.m.Y H:i:s',
        'd.m.Y',
    ];
    
    foreach ($formats as $format) {
        $dt = DateTime::createFromFormat($format, $input);
        $errors = DateTime::getLastErrors();
        if ($dt !== false && $errors['warning_count'] === 0 && $errors['error_count'] === 0 
            && $dt->format($format) === $input) {
            return $dt;
        }
    }
    return null;
}
?>

2. 為什麼要檢查 format() === 原輸入?

<?php
// PHP DateTime 會自動修正溢出值
$dt = DateTime::createFromFormat('Y-m-d', '2024-02-30');
echo $dt->format('Y-m-d'); // 2024-03-01 (自動進位到3月1日)

// 所以必須對比原輸入
$input = '2024-02-30';
$dt = DateTime::createFromFormat('Y-m-d', $input);
$isValid = $dt && $dt->format('Y-m-d') === $input; // false
?>

三、strtotime() 方案(簡單但有陷阱)

1. 基本用法

<?php
function validateWithStrtotime(string $dateTime): bool {
    $timestamp = strtotime($dateTime);
    if ($timestamp === false) return false;
    
    // 驗證往返一致性
    $back = date('Y-m-d H:i:s', $timestamp);
    // 注意:strtotime 支持多種格式,往返格式可能不同
    // 建議指定預期格式對比
    return $back === $dateTime; // 嚴格模式需格式完全一致
}

// 測試
var_dump(validateWithStrtotime('2024-01-15 14:30:45')); // true
var_dump(validateWithStrtotime('2024-02-30 14:30:45')); // false(返回 false)
var_dump(validateWithStrtotime('next Monday'));         // true 但格式不一致
?>

2. strtotime() 陷阱

  • 解析相對時間:'next Monday'、'+1 day' 會返回有效時間戳
  • 格式寬鬆:'2024/1/5'、'Jan 15 2024' 都能解析
  • 年份 2 位數歧義:'24-01-15' 可能解析為 1924 或 2024
  • 時區依賴:受 date_default_timezone_set() 影響

四、checkdate() - 純日期驗證

<?php
// 專門驗證格里曆日期合法性
var_dump(checkdate(2, 29, 2024)); // true(閏年)
var_dump(checkdate(2, 29, 2023)); // false(平年)
var_dump(checkdate(13, 1, 2024)); // false
var_dump(checkdate(1, 32, 2024)); // false

// 組合使用:分離日期時間驗證
function validateDateTimeSplit(string $dateTime): bool {
    if (!preg_match('/^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})$/', $dateTime, $m)) {
        return false;
    }
    // $m[1]=year, [2]=month, [3]=day, [4]=hour, [5]=min, [6]=sec
    return checkdate((int)$m[2], (int)$m[3], (int)$m[1])
        && $m[4] < 24 && $m[5] < 60 && $m[6] < 60;
}
?>

五、完整驗證器類封裝

<?php
declare(strict_types=1);

class DateTimeValidator {
    private array $formats;
    
    public function __construct(array $formats = null) {
        $this->formats = $formats ?? [
            'Y-m-d H:i:s',
            'Y-m-d',
            'Y/m/d H:i:s',
            'Y/m/d',
            'd.m.Y H:i:s',
            'd.m.Y',
            'Y-m-d\TH:i:s',      // ISO 8601
            'Y-m-d\TH:i:sP',     // ISO 8601 帶時區
        ];
    }
    
    public function validate(string $input): bool {
        return $this->parse($input) !== null;
    }
    
    public function parse(string $input): ?DateTime {
        foreach ($this->formats as $format) {
            $dt = DateTime::createFromFormat($format, $input);
            $errors = DateTime::getLastErrors();
            if ($dt !== false 
                && $errors['warning_count'] === 0 
                && $errors['error_count'] === 0
                && $dt->format($format) === $input) {
                return $dt;
            }
        }
        return null;
    }
    
    public function parseOrFail(string $input): DateTime {
        $dt = $this->parse($input);
        if (!$dt) {
            throw new \InvalidArgumentException("無效的日期時間格式:$input");
        }
        return $dt;
    }
    
    // 範圍驗證
    public function validateRange(string $input, ?DateTime $min = null, ?DateTime $max = null): bool {
        $dt = $this->parse($input);
        if (!$dt) return false;
        if ($min && $dt < $min) return false;
        if ($max && $dt > $max) return false;
        return true;
    }
}

// 使用
$validator = new DateTimeValidator();
if ($validator->validate($_POST['birthday'] ?? '')) {
    $dt = $validator->parse($_POST['birthday']);
    // 業務邏輯...
}
?>

六、Laravel/ThinkPHP 框架驗證規則

<?php
// Laravel Validation
$request->validate([
    'birthday' => 'required|date_format:Y-m-d',
    'appointment' => 'required|date_format:Y-m-d H:i:s|after:today',
    'start_date' => 'required|date|before_or_equal:end_date',
]);

// ThinkPHP Validate
class UserValidate extends Validate {
    protected $rule = [
        'birthday' => 'require|dateFormat:Y-m-d',
        'appointment' => 'require|dateFormat:Y-m-d H:i:s|after:time',
    ];
}

// 自定義驗證規則(Laravel)
Validator::extend('valid_datetime', function ($attribute, $value, $parameters, $validator) {
    $dt = DateTime::createFromFormat($parameters[0] ?? 'Y-m-d H:i:s', $value);
    $errors = DateTime::getLastErrors();
    return $dt !== false 
        && $errors['warning_count'] === 0 
        && $errors['error_count'] === 0
        && $dt->format($parameters[0] ?? 'Y-m-d H:i:s') === $value;
});
?>

七、總結:選型建議

場景推薦方案理由
API 參數嚴格驗證DateTime::createFromFormat() + 格式對比精確、安全、可擴展多格式
用戶生日/日期選擇器checkdate() + 簡單正則輕量、專門解決日期邏輯
解析用戶自由輸入strtotime() + 範圍限制兼容性好,但需嚴格限制輸出格式
高性能批量驗證預編譯正則 + checkdate()避免對象創建開銷
框架表單驗證內置 date_format 規則統一錯誤處理、本地化
copyright © 萬盛學電腦網 all rights reserved