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,並嘗試猜測系統時區 (不可靠)。
; 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。
<?php
// bootstrap.php / index.php / config/app.php 最早處執行
date_default_timezone_set('Asia/Taipei');
// 或
ini_set('date.timezone', 'Asia/Taipei'); // 僅影響當前請求
# .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 | 無 |
| UTC | UTC | +00:00 | 無 |
完整列表見 PHP 官方時區列表 或執行 php -r "print_r(DateTimeZone::listIdentifiers());"。
<?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')); // 回傳新物件
date('Y-m-d') 會自動用系統時區:會發出警告且不可靠,必須明確設定。CST、GMT+8 等縮寫:CST 歧義大 (可能指 China/US/Cuba/Australia Standard Time),必須用洲/城市格式。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!