Speedtest-Tracker 项目中的时区配置指南

时区配置的重要性

在部署和使用 Speedtest-Tracker 项目时，正确配置时区对于确保测试结果的时间戳准确显示至关重要。时区设置不当会导致记录的时间与用户本地时间不符，影响数据分析和使用体验。

支持的时区格式

Speedtest-Tracker 使用标准的 PHP 时区格式，这些时区标识符遵循 IANA 时区数据库规范。时区标识符通常采用"区域/城市"的格式，例如：

• 欧洲布鲁塞尔：Europe/Brussels
• 亚洲上海：Asia/Shanghai
• 美国纽约：America/New_York

关键配置参数

项目中与时区相关的配置参数主要有两个：

1. APP_TIMEZONE：设置应用程序使用的时区，影响数据存储和处理的时间基准
2. DISPLAY_TIMEZONE：设置界面显示使用的时区，影响用户看到的时间格式

为了确保一致性，建议将这两个参数设置为相同的时区值。

时区选择建议

对于比利时用户，正确的时区设置应该是"Europe/Brussels"。这个设置会自动处理夏令时(CEST)和标准时间(CET)的转换，无需手动调整。

时间显示格式定制

除了时区设置外，Speedtest-Tracker 还提供了时间显示格式的定制选项：

• DATETIME_FORMAT：控制常规日期时间显示格式
• CHART_DATETIME_FORMAT：专门控制图表中的日期时间显示格式

这些参数使用 PHP 的日期时间格式化字符，允许用户根据个人偏好或地区习惯自定义显示方式。

常见问题解决方案

如果遇到时间显示不正确的问题，可以按照以下步骤排查：

1. 确认 APP_TIMEZONE 和 DISPLAY_TIMEZONE 都设置为正确的时区标识符
2. 检查服务器系统时区设置是否与应用程序设置一致
3. 确保应用程序有权限读取系统的时区信息
4. 在容器化部署时，验证容器内的时区配置

通过正确配置这些参数，可以确保 Speedtest-Tracker 在各种环境下都能准确记录和显示时间信息，为用户提供一致且可靠的使用体验。