php时区未生效需先用date_default_timezone_get()确认实际时区;配置优先级为运行时set() > .htaccess > php.ini;推荐php.ini设asia/shanghai,框架需统一配置,cli和容器环境须单独处理。

PHP时区没生效?先查date_default_timezone_get()返回值
很多情况下你以为设了时区,但date()、strtotime()等函数仍按UTC或系统默认输出,根本原因是date_default_timezone_set()只在当前请求生命周期内生效,且可能被后续代码(比如某些框架初始化逻辑)覆盖。运行一下var_dump(date_default_timezone_get());,确认实际生效的时区——它未必是你在php.ini里写的那个。
三种持久化方式优先级和适用场景
PHP时区配置有三层作用域,优先级从高到低:运行时调用 date_default_timezone_set() > .htaccess 或 Apache php_value > php.ini。线上环境推荐直接改php.ini,开发环境若用Docker可挂载自定义php.ini;共享主机无法改全局配置时,才考虑.htaccess(仅Apache有效),但要注意AllowOverride Options必须启用。
-
php.ini中写date.timezone = "Asia/Shanghai"——最稳定,重启PHP-FPM或Apache后永久生效 -
.htaccess中写php_value date.timezone "Asia/Shanghai"——无需重启,但每请求解析一次,性能略损 - 在入口文件开头调用
date_default_timezone_set("Asia/Shanghai")——最灵活,但得确保所有入口(包括CLI脚本、异步任务)都执行,漏一个就出问题
Asia/Shanghai不是唯一选择,注意夏令时陷阱
中国大陆虽不用夏令时,但PRC这个时区标识已被PHP弃用(自7.0起警告,8.0+报错),必须用Asia/Shanghai。而像Europe/Berlin这类会切夏令时的时区,date()自动处理偏移,但如果你手动算时间差(比如strtotime('+1 hour')),底层仍基于当前UTC偏移——这意味着3月最后一个周日之后,+1小时实际是+2小时本地时间,容易误判。
- 避免用
GMT+8或UTC+8这种固定偏移写法,它们不识别夏令时,也不被PHP官方支持 - CLI脚本常被忽略:
php -i | grep timezone看到的是Web服务器的配置,CLI可能走另一套php.ini,需单独检查php --ini - 容器环境里,宿主机时区不影响PHP,必须显式配置
date.timezone,光靠ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime没用
框架里时区配置可能覆盖全局设置
Laravel、Symfony等框架会在启动时调用date_default_timezone_set(),以config/app.php里的'timezone' => 'UTC'为准——这会直接覆盖php.ini的值。此时改php.ini无效,必须统一在框架配置里设为"Asia/Shanghai",否则日志时间、队列延迟、缓存过期全乱套。
立即学习“PHP免费学习笔记(深入)”;
- ThinkPHP 6.x 在
config/app.php中设'default_timezone' => 'Asia/Shanghai' - CodeIgniter 4 通过
app/Config/App.php的$timezone属性控制 - 哪怕框架没显式设时区,也建议在
bootstrap阶段加一行date_default_timezone_set(ini_get('date.timezone') ?: 'Asia/Shanghai');兜底
date_default_timezone_get()才是你唯一该信的依据。











