PHP.ini 中 date.timezone 時區設定完整指南

問題背景

PHP 5.1.0 起引入 date.timezone 設定，預設關閉導致時間顯示為格林威治標準時間（GMT），與北京時間相差 8 小時。許多開發者在設定時發現官方文檔未列出 "PRC" 等簡寫，僅支援 "Asia/Shanghai" 等完整格式，且 XAMPP 環境下修改 php.ini 常不生效。

正確的時區設定值

PHP 使用 IANA 時區資料庫格式，常用中文區域設定：

說明： "PRC" 雖不在官方標準列表中，但 PHP 內建支援作為 "Asia/Shanghai" 的別名，可正常使用。

修改步驟

1. 找到正確的 php.ini 檔案位置
2. 搜尋 ;date.timezone =
3. 移除前方分號 ; 啟用設定
4. 設定值，例如：date.timezone = Asia/Shanghai
5. 重啟 Web 服務（Apache/Nginx/PHP-FPM）

XAMPP 環境特別注意

XAMPP 將 PHP 設定檔放在 apache/bin/php.ini，而非 php 目錄下。修改錯誤檔案是導致不生效的主因。

# XAMPP 典型路徑
C:\xampp\apache\bin\php.ini  ← 正確位置
C:\xampp\php\php.ini         ← 錯誤位置（僅 CLI 使用）

驗證方法

<?php
echo date('Y-m-d H:i:s');  // 輸出應為本地時間
echo ini_get('date.timezone');  // 確認設定生效
?>

常見錯誤排查

• 修改後未重啟服務
• 編輯錯誤的 php.ini（CLI vs Apache 模組）
• 設定值拼寫錯誤（區分大小寫）
• php.ini 中有多處 date.timezone 設定，以最後一處為準