参考资料

  1. Fresns PHP函数 官方要求
  2. Fresns 的软链接,核心是解决“本地存储的文件无法被公网访问”的问题
  3. Fresns 伪静态设置
  4. Supervisor 是 Fresns 在生产环境中运行队列的标准方案
  5. Fresns 对 PHP 超时限制有明确要求,主要是为了避免插件依赖下载超时
  6. Composer 换国内源是提升依赖下载速度最直接的方法
  7. Fresns 的队列,它的核心是按需配置,并非安装必选项
  8. Fresns 在宝塔面板下的目录所有权,通常需要设为 www 用户和 www 用户组

Fresns 的时区配置核心是在 .env 文件中设置 APP_TIMEZONE 参数

Fresns 的时区配置核心是在 .env 文件中设置 APP_TIMEZONE 参数。为了确保跨时区数据一致性,Fresns 底层采用 UTC 标准,并自动处理时间录入与输出的转换。

📂 配置项说明

配置项默认值说明
APP_TIMEZONEAsia/Shanghai数据库时区,必须使用 PHP 时区函数(地区命名格式)

⚙️ 配置示例

在 Fresns 根目录的 .env 文件中,找到并修改该配置项:

# 中国标准时间(UTC+8)
APP_TIMEZONE=Asia/Shanghai

其他 UTC+8 地区的可选值包括 Asia/Singapore、Australia/Perth 等,效果等同。

💡 关键要点

  • 必须与数据库一致:APP_TIMEZONE 的时区设置需要与数据库服务器的系统时区保持一致,否则可能导致入库时间不准确。

  • 验证数据库时区:登录后台,在「仪表盘」的“系统信息”中可以查看当前数据库所属的 UTC 时区,据此来核对 .env 的配置是否正确。

  • 夏令时提示可忽略:如果你所在的地区(如洛杉矶)有夏令时,后台可能会提示时区异常(因为 UTC 偏移量随季节变化,而映射是固定的)。只要你的 .env 配置正确,这个提示可以忽略,不影响功能。

作者:王壹杰
时间:2026-10-01 16:43:29
来源:https://fresns.ciilii.com/