1. 问题背景与常见误区
在Docker环境中运行PHP应用程序时，开发者可能会遇到一个令人困惑的现象：即使在PHP配置中正确设置了时区，PHP输出的时间仍然与实际时间存在一个固定的、非整数小时的偏差，例如20分钟。这通常会让人误以为是PHP的时区配置问题。
例如，以下PHP配置和代码片段是常见的时区设置方式：
php.ini 配置：
[Date] date.timezone = Japan
PHP脚本内设置：
立即学习“PHP免费学习笔记（深入）”；
<?php
$date = new \DateTime('now', new DateTimeZone('Japan'));
echo $date->format('d.m.Y H:i:s');
?>尽管如此，如果实际时间是 10.11.2021 17:34:17（日本时区），PHP输出却可能是 10.11.2021 17:14:17，存在20分钟的偏差。这种非标准、非整数小时的偏差强烈暗示问题并非出在时区设置本身，因为时区偏差通常以小时为单位。
2. 核心问题：Docker容器系统时间不同步
经过深入排查，发现此类问题的根本原因不在于PHP的时区配置，而在于Docker容器内部的系统时间与宿主机的系统时间存在不同步。PHP获取时间是基于其运行环境（即Docker容器）的系统时间。如果容器的系统时间本身就是错误的，那么无论PHP如何正确地解释和格式化这个时间，最终显示的结果依然是错误的。
这种20分钟的固定偏差，往往是由于容器启动时未能正确同步宿主机时间，或者容器内部的时间服务（如NTP客户端）未正常工作，导致其内部时钟漂移。
3. 解决方案：同步Docker容器的系统时间
解决此问题的关键在于强制Docker容器的系统时间与宿主机的硬件时钟进行同步。这可以通过在特权模式下运行一个轻量级容器来执行hwclock -s命令实现。
解决方案命令：
docker run --rm --privileged alpine hwclock -s
命令解析：
- docker run: 运行一个新的Docker容器。
- --rm: 容器退出后自动删除。这确保了不会留下不必要的容器实例。
- --privileged: 这是解决问题的关键。--privileged标志赋予容器几乎所有宿主机的权限，包括访问硬件设备。hwclock命令通常需要这样的特权来读取或设置系统硬件时钟。
- alpine: 使用轻量级的Alpine Linux镜像。这个镜像非常小巧，包含基本的Linux工具，适合执行一次性任务。
- hwclock -s: 这是在Alpine容器内部执行的命令。
- hwclock: 一个用于查询和设置硬件时钟（RTC, Real Time Clock）的工具。
- -s (或 --hctosys): 表示将硬件时钟（RTC）的时间设置为系统时间。通过此操作，容器的系统时间会被校准为宿主机的硬件时钟时间。
操作步骤：
- 在宿主机终端中，运行上述命令：
docker run --rm --privileged alpine hwclock -s
- 命令执行后，它会启动一个临时的Alpine容器，执行时间同步操作，然后自动退出并删除容器。
- 此时，受影响的Docker容器（运行PHP应用的容器）的系统时间应该已经同步。
验证方法：
在执行同步命令后，重新运行PHP脚本来验证时间是否已正确显示：
<?php
// 确保php.ini或脚本内已设置正确的时区
// date.timezone = Japan (或您所需的时区)
$date = new \DateTime('now', new DateTimeZone('Japan'));
echo $date->format('d.m.Y H:i:s');
?>此时，PHP输出的时间应与您所选时区的实际时间一致。
4. 注意事项
- --privileged的安全性考量： 使用--privileged模式运行容器会赋予其极高的权限，应谨慎使用。在生产环境中，如果需要更持久或更安全的解决方案，可以考虑其他时间同步策略。
-
持久化问题： hwclock -s命令仅在执行时对当前运行的容器有效。如果PHP容器重启，其系统时间可能会再次出现偏差。
- 解决方案一（手动）： 每次发现时间偏差或容器重启后，手动执行上述同步命令。
- 解决方案二（自动化）： 对于生产环境，可以考虑在Docker Compose文件或容器启动脚本中集成时间同步机制。例如，在PHP容器启动前，先执行时间同步命令。或者，在Dockerfile中安装并配置NTP客户端，让容器在启动后自动同步时间。
- 示例（Docker Compose）： 可以在docker-compose.yml中添加一个初始化服务，但直接在服务启动前同步宿主机时间可能更有效。更常见的是确保宿主机时间准确，并让容器通过NTP或宿主机提供的机制同步。
- 宿主机时间准确性： 确保Docker宿主机的系统时间本身是准确的，最好配置宿主机使用NTP服务进行时间同步。如果宿主机时间不准，容器同步后依然会继承错误的宿主机时间。
- hwclock与date： 在Linux系统中，date命令用于操作系统时间，而hwclock用于操作硬件时钟（RTC）。hwclock -s的目的是将硬件时钟的时间写入系统时钟。在Docker容器中，通常没有直接的硬件时钟概念，但这个命令可以触发某种同步机制，使其从宿主机获取正确的时间。
5. 总结
当PHP在Docker中出现非整数小时的时间偏差时，不要局限于PHP时区配置。问题的核心往往在于Docker容器的系统时间与宿主机不同步。通过使用docker run --rm --privileged alpine hwclock -s命令，可以有效地强制容器同步其系统时间，从而解决PHP时间显示不准确的问题。在实施此解决方案时，务必考虑--privileged模式的安全性以及时间同步的持久化策略，以确保生产环境的稳定性和准确性。
