萬盛學電腦網

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

PHP 常用工具函數庫:日期、IP、驗證、重導向、時間差計算

整理實戰高頻、可直接複製的 PHP 工具函數,涵蓋日期運算、客戶端 IP 獲取、日期時間驗證、時間差計算、頁面重導向三種方式。

1. 日期加減運算

<?php
/**
 * 日期加減
 * @param string $date 'Y-m-d'
 * @param int $interval 間隔數值
 * @param string $unit 'y'年 'm'月 'd'日
 * @return string 'Y-m-d'
 */
function date_add($date, $interval, $unit = 'd') {
    $dt = DateTime::createFromFormat('Y-m-d', $date);
    if (!$dt) return false;
    $dt->modify(($interval >= 0 ? '+' : '') . abs($interval) . ' ' . $unit);
    return $dt->format('Y-m-d');
}

// 用法
echo date_add('2024-01-31', 1, 'm'); // 2024-02-29 (閏年自動處理)
echo date_add('2024-01-31', -10, 'd'); // 2024-01-21

2. 取得星期幾

function get_weekday($date) { // 返回 0(日)~6(六)
    $dt = DateTime::createFromFormat('Y-m-d', $date);
    return $dt ? (int)$dt->format('w') : false;
}

3. 獲取客戶端真實 IP

function get_client_ip() {
    $headers = [
        'HTTP_X_FORWARDED_FOR',
        'HTTP_CLIENT_IP',
        'HTTP_X_REAL_IP',
        'REMOTE_ADDR'
    ];
    foreach ($headers as $h) {
        if (!empty($_SERVER[$h])) {
            $ips = explode(',', $_SERVER[$h]);
            return trim($ips[0]); // 取第一個 (最原始客戶端)
        }
    }
    return 'Unknown';
}

4. 日期/時間合法性驗證

function is_valid_date($date) { // Y-m-d
    $d = DateTime::createFromFormat('Y-m-d', $date);
    return $d && $d->format('Y-m-d') === $date;
}
function is_valid_time($time) { // H:i:s
    $d = DateTime::createFromFormat('H:i:s', $time);
    return $d && $d->format('H:i:s') === $time;
}
function is_valid_datetime($dt) { // Y-m-d H:i:s
    $d = DateTime::createFromFormat('Y-m-d H:i:s', $dt);
    return $d && $d->format('Y-m-d H:i:s') === $dt;
}

5. 兩日期時間差 (秒/分/時/天)

/**
 * @param string $dt1 'Y-m-d H:i:s'
 * @param string $dt2 'Y-m-d H:i:s'
 * @param string $unit 's'秒 'i'分 'h'時 'd'天
 * @return int|false 差值 (dt1 - dt2)
 */
function datetime_diff($dt1, $dt2, $unit = 'd') {
    $units = ['s'=>1, 'i'=>60, 'h'=>3600, 'd'=>86400];
    if (!isset($units[$unit])) return false;
    $t1 = strtotime($dt1);
    $t2 = strtotime($dt2);
    if ($t1 === false || $t2 === false) return false;
    return floor(($t1 - $t2) / $units[$unit]);
}
// 用法
echo datetime_diff('2024-01-15 12:00:00', '2024-01-10 00:00:00', 'd'); // 5
echo datetime_diff('2024-01-15 12:00:00', '2024-01-15 10:00:00', 'h'); // 2

6. 頁面重導向三種方式

<?php
// 1. HTTP Header (推薦,必須在輸出前)
header('Location: https://example.com/target.php');
exit;

// 2. JS 重導向 (已有輸出時)
echo '<script>window.location.href = "target.php";</script>';

// 3. Meta Refresh (極少用)
echo '<meta http-equiv="Refresh" content="0;url=target.php">';

使用建議

  • 日期運算優先用 DateTime 類,避免 strtotime 邊界 Bug (如 2038 年、月份天數)。
  • IP 獲取注意代理鏈,X-Forwarded-For 可偽造,信任前提是已知反向代理 (Nginx/Cloudflare) 正確設定。
  • 驗證函數用 DateTime::createFromFormat 嚴格匹配格式,比正則可靠。
  • 重導向務必加 exit 防止後續代碼執行。
copyright © 萬盛學電腦網 all rights reserved