php 8.5 要求显式设置 date.timezone,否则时间函数触发警告或静默错误;必须用 iana 时区名(如 asia/shanghai),禁用 gmt+8 等非标准格式;cli 与 web 可能加载不同 php.ini,需分别配置;运行时可用 date_default_timezone_set() 动态覆盖,但须在首次时间函数调用前执行。

php.ini 里 date.timezone 必须显式设置
PHP 8.5 不再容忍 date.timezone 为空或注释掉——否则所有时间相关函数(date()、new DateTime())会触发 Warning: date(): It is not safe to rely on the system's timezone settings,且 DateTime 构造可能返回 false 或静默出错。
实操建议:
- 打开你的主
php.ini(用php --ini确认路径),找到;date.timezone =这一行 - 去掉分号,并填入合法时区标识符,例如:
date.timezone = Asia/Shanghai - 别写成
date.timezone = GMT+8或date.timezone = CST—— 这些不是 IANA 时区名,PHP 会静默忽略 - 改完后必须重启 Web 服务器(如 Apache/Nginx)或 PHP-FPM 进程,仅 reload 不生效
运行时用 date_default_timezone_set() 覆盖配置
开发中常需临时切换时区(比如处理多地区用户订单),这时不能动 php.ini,得在代码里设。
注意点:
立即学习“PHP免费学习笔记(深入)”;
- 必须在首次调用
date()、strtotime()或实例化DateTime前调用date_default_timezone_set() - 传参必须是字符串,且是 PHP 支持的时区名(可用
timezone_identifiers_list()查全量) - 常见误写:
date_default_timezone_set('Beijing')(无效)、date_default_timezone_set(8)(类型错) - 示例正确写法:
date_default_timezone_set('Asia/Shanghai');
CLI 和 Web SAPI 时区可能不一致
你用 php -i | grep "date.timezone" 看到的值,未必等于 Apache 或 Nginx 下 PHP 实际用的值——因为 CLI 和 Web 可能加载不同 php.ini。
排查方法:
- Web 环境下输出
phpinfo();,搜date.timezone,看 “Loaded Configuration File” 路径 - CLI 下执行
php --ini,对比配置文件路径是否一致 - 若不一致,两个地方都要配,或统一用
PHP_INI_SCAN_DIR指向同一配置目录 - 某些 Docker 镜像(如
php:8.5-apache)默认没配date.timezone,容易漏掉
date() 和 DateTime 构造对时区敏感的差异
date() 完全依赖 date.timezone 或 date_default_timezone_set();而 DateTime 默认用系统本地时区(即未设时区时行为不可控)。
关键区别:
-
date('Y-m-d H:i:s')总按当前默认时区输出 -
new DateTime()若没指定时区参数,会按“系统时区”解析字符串(可能和date()不一致) - 安全写法是显式传时区:
new DateTime('now', new DateTimeZone('Asia/Shanghai')) - 用
DateTime::createFromFormat()时更危险——它默认按date.timezone解析,但不报错,容易埋坑
date.timezone 的实际生效位置和时机,比想象中更容易被绕过去。











