
date_default_timezone_set() 设置上海时区最直接
PHP 默认不自动识别系统时区,date()、strtotime() 等函数全靠它驱动。想让时间显示为上海(东八区),必须显式调用 date_default_timezone_set(),不能只改 php.ini 或依赖服务器配置。
常见错误是写成 date_default_timezone_set('CST')——这在 PHP 里指美国中部时间,不是中国标准时间;也有人试 'PRC',虽旧版兼容但已废弃,PHP 8+ 可能警告。
- 正确写法:
date_default_timezone_set('Asia/Shanghai') - 建议放在项目入口(如
index.php最开头),或框架的初始化逻辑里,避免被后续代码覆盖 - 调用后可用
date_default_timezone_get()验证是否生效,返回值应为Asia/Shanghai,不是UTC或空字符串
php.ini 中设置 timezone 要重启服务才生效
改 php.ini 的 date.timezone 项确实一劳永逸,但很多人改完没生效,是因为漏了关键一步:Web 服务(Apache/Nginx)或 PHP-FPM 进程必须重启,仅 reload 不够。
典型错误路径:/etc/php/8.1/apache2/php.ini(Debian/Ubuntu)或 C:\xampp\php\php.ini(Windows XAMPP),改完记得确认是当前运行的 PHP 版本对应的那个文件。
立即学习“PHP免费学习笔记(深入)”;
- 配置项写法:
date.timezone = Asia/Shanghai(等号前后不留空格) - 如果用的是 CLI 模式(比如跑脚本),CLI 版本的
php.ini可能和 Web 版本不同,需单独检查 - 某些共享主机不允许改
php.ini,此时只能靠date_default_timezone_set()在代码中补救
DateTime 构造时传时区比全局设置更可控
当需要混用多个时区(比如存 UTC、展示上海时间),硬设全局时区反而容易出错。这时推荐用 DateTime 类显式绑定时区,逻辑更清晰、不易污染其他时间操作。
例如日志记录用 UTC 存储,前端展示转上海时间——全局设成 Asia/Shanghai 会导致 new DateTime() 默认生成上海时间,可能误存本地时间。
- 安全写法:
$dt = new DateTime('now', new DateTimeZone('Asia/Shanghai')); - 转换时区:
$dt->setTimezone(new DateTimeZone('UTC'));,比date()+ 全局时区更可靠 - 注意:
DateTime::__construct()第二个参数为DateTimeZone对象,不是字符串,别直接传'Asia/Shanghai'
docker 或容器环境里时区设置容易被覆盖
Docker 容器默认没有时区信息,即使宿主机是上海时间,PHP 容器内 date_default_timezone_get() 常返回 UTC 或空。光在 PHP 层设不够,得从基础镜像或启动参数入手。
常见现象:本地开发正常,上线 Docker 后所有时间快 8 小时或慢 8 小时,查半天发现是容器没时区数据。
- 构建镜像时加一句:
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime - 同时确保安装了 tzdata 包(Alpine 用
apk add tzdata,Debian/Ubuntu 用apt-get install -y tzdata) - PHP 层仍建议保留
date_default_timezone_set('Asia/Shanghai'),双保险,避免镜像配置遗漏
时区不是“设一次就永远对”的东西,尤其跨环境部署时,Asia/Shanghai 这个字符串本身没问题,但它的生效依赖 PHP 初始化时机、容器底层、甚至 systemd-timedated 服务状态。每次时间出错,先验证 date_default_timezone_get() 返回值,比猜配置快得多。











