参考资料

  1. Fresns 对 PHP 超时限制有明确要求,主要是为了避免插件依赖下载超时
  2. Fresns 的 APP_KEY 是应用加密密钥
  3. Fresns PHP函数 官方要求
  4. Fresns 的 PHP 扩展要求分为 必选 和 按需安装 两类
  5. Fresns 终端平台编号
  6. 配置 Fresns 的队列进程,核心是使用 Supervisor 守护
  7. Fresns 的代理环境配置,核心是让系统在 CDN 或反向代理
  8. OpenResty 本质上是一个集成了 Nginx 与 LuaJIT 的 Web 平台

Fresns 的队列,它的核心是按需配置,并非安装必选项

关于 Fresns 的队列,它的核心是按需配置,并非安装必选项。

如果安装的插件明确要求了“队列”功能,才需要为主程序进行配置;如果没有特别说明,通常可以忽略,系统默认的同步执行模式(sync)足够应付。

📂 队列配置方式

如果需要启用,先在 .env 文件中配置连接方式,推荐 redis 或 database。

方式一:Redis(推荐)

QUEUE_CONNECTION=redis

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_QUEUE=fresns

方式二:Database(无需额外服务)

QUEUE_CONNECTION=database

配置完成后,必须配置进程守护(如 Supervisor)来常驻消费队列,否则任务不会被真正执行。启动命令为 php artisan queue:work。

⚙️ 关于 PHP 函数

如果配置了 Redis 或 database 等异步队列,必须确保服务器保留了 pcntl_signal、pcntl_alarm、pcntl_async_signals 这三个函数。如果使用默认的 sync 同步队列,则不需要它们。

💡 多站点部署注意

如果同一台服务器运行了多个 Fresns 实例,必须修改 REDIS_QUEUE 名称或使用不同的 REDIS_DB,避免队列数据互相混淆。

🔄 队列进程重启

当插件升级后,如果插件说明中要求重置队列进程,需要在 Supervisor 管理器中找到 Fresns 队列进程,执行“重启”操作,使新代码生效。

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