LAMP 環境下,三層時區不一致會導致時間顯示錯誤、定時任務偏移、日誌分析混亂等「陰差陽錯」的 Bug。本文提供生產環境級的統一時區設定方案,以 Asia/Shanghai (UTC+8) 為例。
# 方法 1:timedatectl (推薦)
timedatectl set-timezone Asia/Shanghai
# 方法 2:符號連結 (傳統)
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
# 驗證
date +"%Z %z" # CST +0800
dpkg-reconfigure tzdata # 互動式選擇 Asia/Shanghai
# 或非互動式
echo "Asia/Shanghai" > /etc/timezone
dpkg-reconfigure -f noninteractive tzdata
[mysqld]
default-time-zone = '+08:00'
# 或使用具名時區 (需載入時區表)
# default-time-zone = 'Asia/Shanghai'
修改後重啟:systemctl restart mysqld
SET GLOBAL time_zone = '+08:00'; // 需 SUPER 權限,重啟失效
SET SESSION time_zone = '+08:00'; // 僅當前連線
mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
# 之後可在配置檔使用 default-time-zone = 'Asia/Shanghai'
若 OS 時區已正確,MySQL 預設會繼承系統時區,無需額外設定。 僅在容器化環境或跨時區部署時才需顯式指定。
date.timezone = "Asia/Shanghai"
修改後重啟 PHP-FPM / Apache。
// 方法 1:ini_set (影響 date() 等函數)
ini_set('date.timezone', 'Asia/Shanghai');
// 方法 2:date_default_timezone_set (官方推薦)
date_default_timezone_set('Asia/Shanghai');
Asia/Shanghai // 中國標準時間 (無夏令時間)
Asia/Taipei // 台灣時間 (同 UTC+8)
Asia/Hong_Kong // 香港時間
UTC // 世界協調時間
America/New_York // 美東時間 (含夏令時間)
Europe/London // 倫敦時間 (含夏令時間)
FROM php:8.2-fpm
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
&& echo "Asia/Shanghai" > /etc/timezone \
&& echo "date.timezone = Asia/Shanghai" > /usr/local/etc/php/conf.d/timezone.ini
services:
php:
environment:
- TZ=Asia/Shanghai
mysql:
environment:
- TZ=Asia/Shanghai
command: --default-time-zone=+08:00
query("SELECT NOW()")->fetchColumn() . "\n";
// Linux (需 shell_exec 權限)
echo "Linux: " . shell_exec('date +"%Y-%m-%d %H:%M:%S %Z"') . "\n";
輸出三行時間應完全一致 (秒級差異屬正常)。
統一時區的核心原則:以系統層為準,上層應用跟隨或顯式對齊。生產環境建議:OS 設定 Asia/Shanghai → MySQL 繼承系統時區 → PHP 設定 date.timezone = Asia/Shanghai。容器化部署時透過環境變數 TZ 統一注入,消除時區 Bug 根源。