萬盛學電腦網

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

解決 PHP "date() timezone" 警告:正確設定時區的三種方式

錯誤訊息解析

PHP Warning: date(): It is not safe to rely on the system's timezone settings.
You are *required* to use the date.timezone setting or the date_default_timezone_set() function.
We selected 'Asia/Chongqing' for 'CST/8.0/no DST' instead in /path/to/file.php on line 160

原因:PHP 5.1+ 強制要求明確設定時區,否則每次呼叫日期時間函式 (date(), strtotime(), DateTime 等) 都會發出 E_WARNING,並嘗試猜測系統時區 (不可靠)。

三種設定方式 (優先序由高到低)

1. php.ini 全域設定 (推薦生產環境)

; php.ini
date.timezone = "Asia/Taipei"  ; 台灣
; date.timezone = "Asia/Shanghai" ; 中國大陸
; date.timezone = "Asia/Hong_Kong" ; 香港
; date.timezone = "UTC"            ; 統一用 UTC 存儲,顯示層轉換

修改後重啟 PHP-FPM/Apache:systemctl reload php-fpm 或 apachectl graceful。

2. 程式碼中動態設定 (框架啟動檔/入口檔)

<?php
// bootstrap.php / index.php / config/app.php 最早處執行
date_default_timezone_set('Asia/Taipei');
// 或
ini_set('date.timezone', 'Asia/Taipei'); // 僅影響當前請求

3. .htaccess / Apache 虛擬主機 (共享主機無權改 php.ini 時)

# .htaccess
php_value date.timezone "Asia/Taipei"

# Apache vhost

  php_value date.timezone "Asia/Taipei"

時區識別字對照表 (常用中文區)

地區時區識別字UTC 偏移夏令時
台灣Asia/Taipei+08:00無
中國大陸Asia/Shanghai+08:00無
香港Asia/Hong_Kong+08:00無
新加坡Asia/Singapore+08:00無
東京Asia/Tokyo+09:00無
UTCUTC+00:00無

完整列表見 PHP 官方時區列表 或執行 php -r "print_r(DateTimeZone::listIdentifiers());"。

現代最佳實踐:使用 DateTime 物件

<?php
// 1. 指定時區建立
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));

// 2. 從字串解析 (自動處理時區)
$dt = new DateTime('2024-01-15 14:30:00', new DateTimeZone('UTC'));
$dt->setTimezone(new DateTimeZone('Asia/Taipei')); // 轉換顯示時區

// 3. 格式化輸出
echo $dt->format('Y-m-d H:i:s T'); // 2024-01-15 22:30:00 CST

// 4. 計算差異
$diff = $dt1->diff($dt2);
echo $diff->format('%d天 %h小時 %i分鐘');

// 5. 不可變版本 (PHP 5.5+)
$dtImmutable = new DateTimeImmutable('now', new DateTimeZone('UTC'));
$newDt = $dtImmutable->setTimezone(new DateTimeZone('Asia/Taipei')); // 回傳新物件

常見誤區

  1. 以為 date('Y-m-d') 會自動用系統時區:會發出警告且不可靠,必須明確設定。
  2. 用 CST、GMT+8 等縮寫:CST 歧義大 (可能指 China/US/Cuba/Australia Standard Time),必須用洲/城市格式。
  3. 資料庫存儲用本地時間:資料庫一律存 UTC (TIMESTAMP/DATETIME 配合 UTC 時區),應用層/顯示層才轉換使用者時區。
  4. ini_set('date.timezone') 不影響 date_default_timezone_get() 回傳值 (僅影響當前請求的日期函式),建議雙管齊下。

快速驗證腳本

<?php
// test_timezone.php
echo "ini_get: " . ini_get('date.timezone') . "\n";
echo "date_default_timezone_get: " . date_default_timezone_get() . "\n";
echo "date(): " . date('Y-m-d H:i:s T') . "\n";
$dt = new DateTime();
echo "DateTime: " . $dt->format('Y-m-d H:i:s T') . "\n";

執行 php test_timezone.php 確認輸出時區一致、無警告。

結語

時區設定是 PHP 專案上線的「必做動作」,而非可選優化。採用 php.ini 設定 UTC + 應用層 DateTimeImmutable 處理使用者時區,是現代化、可國際化、可維運的標準作法。立即檢查你的專案,消除這個噁心的 Warning!

copyright © 萬盛學電腦網 all rights reserved