php.ini 的 date.timezone 是全局默认时区,php 启动时读取该配置作为 date() 等函数的默认时区;未设置会触发警告;需用 iana 时区名(如 asia/shanghai),修改后须重启服务;date_default_timezone_set() 可运行时覆盖,datetime 类支持显式时区绑定与转换,更安全可靠;cli 与 web 环境可能加载不同 php.ini,须分别确认或统一在代码中设置。

php.ini 中的 date.timezone 是全局默认时区
PHP 启动时会读取 php.ini 里的 date.timezone 配置,作为所有日期时间函数(如 date()、strtotime())的默认时区。没设这个值,PHP 会报 Warning: date(): It is not safe to rely on the system's timezone settings。
修改方式:打开你的 php.ini 文件(可用 php --ini 查路径),取消注释或添加:
date.timezone = "Asia/Shanghai"
改完必须重启 Web 服务(如 Apache/Nginx + PHP-FPM)或 CLI 环境才生效。注意:Asia/Shanghai 是标准 IANA 时区名,不能写成 GMT+8 或 PRC —— 后两者不被 PHP 识别。
代码中用 date_default_timezone_set() 可覆盖全局设置
这个函数在脚本运行时动态设置当前请求的默认时区,优先级高于 php.ini。适合多租户、多地区业务中按需切换:
立即学习“PHP免费学习笔记(深入)”;
- 它只影响当前脚本生命周期,不影响其他请求或其他进程
- 必须在调用任何时间函数前执行,否则可能触发警告或返回错误时间
- 传入非法时区名(如
"UTC+8")会导致返回false,但不会报错,容易被忽略
示例:
<?php
date_default_timezone_set("Asia/Shanghai");
echo date('Y-m-d H:i:s'); // 输出东八区时间
?>
DateTime 对象可独立指定时区,更灵活也更安全
相比全局或脚本级设置,DateTime 构造时直接绑定时区,避免污染和误判:
-
new DateTime('now', new DateTimeZone('Europe/London'))明确生成伦敦时间对象 - 用
$dt->setTimezone(new DateTimeZone('Asia/Tokyo'))可无损转换时区,不依赖当前默认设置 - 序列化/反序列化时,
DateTime会保留时区信息;而date()输出的是字符串,时区上下文已丢失
尤其在处理用户提交的时间、数据库存储(建议存 UTC)、前端展示(按用户本地时区)时,这种显式控制更可靠。
CLI 和 Web 环境的 php.ini 可能不同,务必确认实际加载的是哪个
很多问题出在这里:你改了 /etc/php/8.1/apache2/php.ini,但 CLI 运行脚本时用的是 /etc/php/8.1/cli/php.ini,结果 Web 正常、命令行报时区警告。
验证方法:
- Web 环境:新建
info.php,写<?php phpinfo(); ?>,搜索Loaded Configuration File - CLI 环境:终端执行
php --ini和php -r "echo date_default_timezone_get();"
如果两个环境需要统一行为,要么分别修改对应 php.ini,要么在代码入口统一调用 date_default_timezone_set() —— 后者更可控,尤其在容器或共享主机上无法改配置时。
php.ini 定基调,date_default_timezone_set() 做兜底,DateTime 才是真正处理时间逻辑的主力。最容易被跳过的,是 CLI 和 Web 加载的 php.ini 不一致,以及把 GMT+8 当合法时区名传给函数。











