将 FreeScout 升级到 PHP 8.5(Ubuntu 26.04 清单)
在将 FreeScout 迁移到 PHP 8.5 之前,请确认 FreeScout 和你运行的每个模块都支持它,然后检查 PHP 扩展、重启队列 worker,并观察日志中的 deprecated since 8.5 消息。Ubuntu 26.04 默认安装 PHP 8.5,因此操作系统升级通常是触发更改的原因。
这对 FreeScout 比对大多数 PHP 应用更重要,因为 FreeScout 处理弃用通知的方式。
为什么 PHP 8.5 可能破坏 FreeScout 模块
每个 PHP 版本都会弃用一些较旧的函数。PHP 8.5 弃用了几个自 PHP 8.0 以来一直无用的函数,包括 curl_close(), imagedestroy(),以及 xml_parser_free()。它还弃用了一些边缘情况,例如使用 null 作为数组键或传递 chr() 超出 0 到 255 的值。
大多数 PHP 应用会记录弃用警告并继续运行。FreeScout 将每个弃用通知转为错误,因此一个遗留调用就会停止遇到它的请求或后台作业。模块可能看起来已安装且健康,但它建立的每个连接都失败。
如果你在升级后看到这些错误, 修复 FreeScout 中的 "deprecated since 8.5" 错误 逐步说明如何找到并修复负责的模块。
升级之前
- 检查支持: 阅读 FreeScout 的发行说明和 PHP 8.5 的系统要求,并确认每个已安装模块都有兼容 PHP 8.5 的版本。
- 先更新模块: 在您仍使用当前 PHP 版本时安装这些更新,以便每个模块在迁移前准备就绪。
- 备份: 复制 FreeScout 目录、数据库和你的 PHP 配置文件。
- 在副本上测试: 如果可以,请先在帮助台的暂存副本上运行升级。
升级后
检查 FreeScout 运行的 PHP 版本
打开 管理 > 系统。它显示你的 Web 服务器使用的 PHP 版本,并列出 FreeScout 所需的 PHP 扩展,标记任何缺失的扩展。匹配命令行 PHP
运行php -v在服务器上。队列工作进程和schedule:runcron 使用命令行 PHP,这可能与 Web 服务器的版本不同。两者必须运行相同版本并具有相同的扩展。重新安装扩展和设置
新的 PHP 版本自带扩展包,并且php.ini文件。安装扩展 管理 > 系统 标记为缺失,然后重新应用自定义设置,例如upload_max_filesize和post_max_size.将 Web 服务器指向新的 PHP
如果你使用 PHP-FPM,请确认你的 Web 服务器使用 PHP 8.5 FPM 套接字或服务,然后重启 PHP-FPM 和 Web 服务器。清除缓存并重启队列工作进程
从您的 FreeScout 目录运行这些命令,以免进程继续运行旧代码:终端php artisan freescout:clear-cache php artisan queue:restart
应在日志中检查什么
打开 管理 > 日志 > 应用日志 在使用帮助台一段时间后。搜索:
is deprecated since 8.5,它指向一个尚未准备好 PHP 8.5 的模块或文件。Providing a value not in-between 0 and 255 is deprecated,来自chr()调用。Using null as an array offset is deprecated.
每个条目都指明文件。位于以下路径下的 Modules/<Name> 告诉你哪个模块需要更新。
测试建立出站连接的功能,因为这些会最先失败:获取邮件、AI 提供商、知识来源,以及 Linear、Jira、Slack 或商店连接器等集成。当模块提供 测试连接 按钮,请使用它。
如果出现问题
在等待更新期间将 FreeScout 移回 PHP 8.4。PHP 8.4 不会将这些函数视为已弃用,因此相同的代码在那里正常运行。同时切换 Web 服务器和命令行 PHP,然后重启 PHP-FPM、Web 服务器和队列工作进程。