date.timezone未设置或配置不生效是PHP日期格式化偏差的根源，会导致date()等函数输出偏移8小时；应优先在php.ini中设为Asia/Shanghai并重启服务，运行时用date_default_timezone_set()补充，再通过date('c')验证是否显示+08:00。
date.timezone 配置不生效或未设置，是 PHP 日期格式化「看起来不准确」最常被忽略的根源。它不会报错，但所有 date()、strtotime()、DateTime 的输出都会悄悄偏移，比如显示成前一天或后一天的零点。
为什么 date.timezone 不设就出问题
PHP 默认使用系统时区（通常是 UTC 或服务器本地时区），而你的业务逻辑、数据库存储、前端展示很可能默认按东八区理解。比如 date('Y-m-d') 在未设时区时返回的是 UTC 时间的当天，而你期望的是北京时间当天 —— 这就差了 8 小时，对「零点」类操作（如 strtotime('today 00:00:00')）尤其致命。
三种设置方式优先级与实操建议
实际生效以「高优先级覆盖低优先级」为准，顺序如下：
-
运行时设置（最高优先级）：在脚本开头立即调用
date_default_timezone_set('Asia/Shanghai')。适合单项目快速修复，但需确保每处入口（包括 include 文件）都执行，否则可能漏掉。 -
php.ini 全局配置（推荐）：修改
date.timezone = Asia/Shanghai。重启 Web 服务后全局生效，date_default_timezone_get()会稳定返回该值。注意：Docker 容器中要进容器改，不能只改宿主机。 -
.htaccess 或 php_value（仅 Apache）：写
php_value date.timezone "Asia/Shanghai"。不适用于 Nginx 或 CLI 环境，且部分共享主机禁用此指令。
验证是否真正生效
别只信配置文件写了，要运行代码确认：
var_dump(date_default_timezone_get());
echo date('Y-m-d H:i:s') . "\n";
echo date('c'); // 输出 ISO 8601 格式，含时区标识，一眼看出是否带 +08:00
如果 date_default_timezone_get() 返回 UTC 或空字符串，说明设置失败；如果 date('c') 显示 +00:00 而非 +08:00，说明时区没起作用。
立即学习“PHP免费学习笔记（深入）”；
容易踩的坑
常见错误不是「没设」，而是「设错位置」或「设错值」：
-
date_default_timezone_set('PRC')在新版 PHP（≥7.4）已废弃，返回 false 且不报错，应改用'Asia/Shanghai'； - CLI 模式和 Web 模式可能读取不同 php.ini，
php -i | grep timezone和phpinfo()输出要分别检查； - MySQL 连接层也可能有自己的时区（
time_zone变量），即使 PHP 时区正确，SELECT NOW()仍可能不一致，需额外执行SET time_zone = '+08:00'； - 使用
DateTime构造时传入字符串（如new DateTime('2025-01-01')），若未显式指定时区，它会按当前date.timezone解析 —— 所以时区必须先设好再 new。
