萬盛學電腦網

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

Linux、PHP、MySQL 時區統一設定完整指南

前言

LAMP 環境下,三層時區不一致會導致時間顯示錯誤、定時任務偏移、日誌分析混亂等「陰差陽錯」的 Bug。本文提供生產環境級的統一時區設定方案,以 Asia/Shanghai (UTC+8) 為例。

一、Linux 系統層時區

CentOS / RHEL 7+

# 方法 1:timedatectl (推薦)
timedatectl set-timezone Asia/Shanghai

# 方法 2:符號連結 (傳統)
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 驗證
date +"%Z %z"  # CST +0800

Ubuntu / Debian

dpkg-reconfigure tzdata  # 互動式選擇 Asia/Shanghai
# 或非互動式
echo "Asia/Shanghai" > /etc/timezone
dpkg-reconfigure -f noninteractive tzdata

二、MySQL 時區設定

1. 配置檔永久生效

[mysqld]
default-time-zone = '+08:00'
# 或使用具名時區 (需載入時區表)
# default-time-zone = 'Asia/Shanghai'

修改後重啟:systemctl restart mysqld

2. 運行時動態設定

SET GLOBAL time_zone = '+08:00';     // 需 SUPER 權限,重啟失效
SET SESSION time_zone = '+08:00';    // 僅當前連線

3. 載入具名時區表 (支援 Asia/Shanghai 寫法)

mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
# 之後可在配置檔使用 default-time-zone = 'Asia/Shanghai'

4. 最佳實務建議

若 OS 時區已正確,MySQL 預設會繼承系統時區,無需額外設定。 僅在容器化環境或跨時區部署時才需顯式指定。

三、PHP 時區設定

1. php.ini 全域設定 (推薦)

date.timezone = "Asia/Shanghai"

修改後重啟 PHP-FPM / Apache。

2. 程式碼中動態設定 (共用主機無權改 ini)

// 方法 1:ini_set (影響 date() 等函數)
ini_set('date.timezone', 'Asia/Shanghai');

// 方法 2:date_default_timezone_set (官方推薦)
date_default_timezone_set('Asia/Shanghai');

3. 常見時區識別字串

Asia/Shanghai  // 中國標準時間 (無夏令時間)
Asia/Taipei    // 台灣時間 (同 UTC+8)
Asia/Hong_Kong // 香港時間
UTC            // 世界協調時間
America/New_York // 美東時間 (含夏令時間)
Europe/London  // 倫敦時間 (含夏令時間)

四、容器化環境 (Docker) 統一時區

Dockerfile

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

docker-compose.yml

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 根源。

copyright © 萬盛學電腦網 all rights reserved