Gimhoy's Blog

阿里云 Alibaba Cloud Linux 3(Alinux 3)升级至 PHP 8.5 踩坑与避坑指南

随着 PHP 官方发布了 PHP 8.5 稳定版(带来了更好的性能与全新特性),许多开发者开始尝试在生产环境中跟进升级。然而,对于使用阿里云 Alibaba Cloud Linux 3 (Alinux 3) 的用户来说,由于系统的软件源标识和底层的限制,在升级过程中很容易遇到依赖冲突或扩展报错。

今天这篇文章,就带大家完整走一遍 从 Alinux 3 默认 PHP 版本平滑升级到 PHP 8.5 的标准流程,并顺便解决升级后极大概率遇到的 opcache 与 JIT 两个经典报错坑。

 

🛠️ 第一阶段:配置 Remi 软件源(解决环境依赖)

Alinux 3 自带的软件源中 PHP 版本较低。我们要借助大名鼎鼎的 Remi 仓库 来获取最新的 PHP 8.5 包。

1. 强制安装 Remi 释放包

由于 Alinux 3 的 system-release 系统标识与标准的 CentOS 8 存在差异,直接安装 Remi 包会触发 system-release(releasever) = 8 is needed 报错。我们必须通过 --nodeps 强制跳过依赖检查:

sudo rpm -ivh https://rpms.remirepo.net/enterprise/remi-release-8.rpm --nodeps --force

2. 修改repo文件

Remi源仅适配CentOS 8发行版,而在Alibaba Cloud Linux 3中,系统的$releasever变量值与CentOS 8不同,会导致DNF解析后的地址无效,进而导致下载RPM包失败。我们通过手动指定$releasever解决这一问题。

打开/etc/yum.repos.d文件夹,将remi.repo、remi-modular.repo和remi-safe.repo中的$releasever全部替换为8.

3. 备份现有配置(核心生产环境必做!)

在执行重大升级前,务必先备份当前的 PHP 配置文件和扩展配置:

sudo cp -r /etc/php.ini /etc/php.ini.bak
sudo cp -r /etc/php.d/ /etc/php.d.bak/

 

🚀 第二阶段:使用 DNF 模块流一键升级

Alinux 3 支持 DNF 的模块流(Stream)管理,这使得我们在不同大版本之间切换变得非常平滑。

1. 切换 DNF 模块流到 PHP 8.5

执行以下命令,告诉系统我们要将 PHP 软件源整体切换到 Remi 的 8.5 版本:

sudo dnf module switch-to php:remi-8.5 -y

(如果该命令在你的环境中报错,可以尝试组合命令:sudo dnf module reset php -y && sudo dnf module enable php:remi-8.5 -y)

2. 执行系统更新

切换完源后,直接使用更新命令。系统会自动为你把旧版本的 PHP 包及核心扩展统一替换为 PHP 8.5:

sudo dnf update php\* -y

 

⚠️ 第三阶段:解决升级后的两大经典“暗坑”

当你满心欢喜地运行 php -v 时,大概率会遇到以下两个由 PHP 8.5 底层机制变更引起的报错。请按照以下方法修复:

💥 坑一:提示 Failed loading Zend extension 'opcache'

• 原因分析:PHP 8.5 发生了一项重大变化 —— Opcache 扩展由原先的“动态共享扩展(.so 文件)”改为了“内置静态编译”。它已经直接合并进 PHP 核心,不再需要、也不存在 opcache.so 文件了。旧配置中的 zend_extension=opcache.so 会直接导致报错。

• 修复方法:

打开 /etc/php.d/10-opcache.ini(或全局 /etc/php.ini),找到带有 zend_extension=opcache.so 的那一行,在行首加上分号 ; 将其注释掉或直接删除该行:ini

; 注释掉这一行,8.5 已经内置,不再需要动态加载
; zend_extension=opcache.so

💥 坑二:提示 JIT is incompatible with third party extensions... JIT disabled.

• 原因分析:PHP 8.5 的 JIT(即时编译器)架构进行了安全调整。明确禁止与任何“修改或设置自定义操作码处理器(user opcode handlers)”的第三方扩展同时启用。如果你安装了 Swoole、Yaf、Yar 或某些旧版性能监测探针,它们会与 JIT 互斥,导致 JIT 自我禁用并抛出警告。

• 修复方法(二选一):

• 方案 A(推荐,最省心):直接关闭 JIT。Swoole 本身作为常驻内存框架已经极快,JIT 的额外提升对绝大多数 Web 站点微乎其微。打开 /etc/php.d/10-opcache.ini,将 opcache.jit 的值修改为 0:

opcache.jit=0

• 方案 B:如果你强依赖 JIT,请尝试将 swoole 等冲突扩展通过 sudo dnf update php-swoole 升级到完全适配 PHP 8.5 底层机制的最新版本。

 

🎉 第四阶段:验证并重启服务

完成上述配置修复后,我们来检验最终成果。

1. 验证 PHP 版本

再次运行版本检查命令:

php -v

正确输出示例:

PHP 8.5.12 (cli) (built: ... ) ( NTS )
Copyright (c) The PHP Group
with Zend OPcache v8.5.12, Copyright (c), by Zend Technologies

所有的报错与警告信息应该已经全部消失。

2. 重启 Web 服务

最后,别忘了重启 PHP-FPM 进程管理器,让你的 Nginx 或 Apache 站点正式加载并启用全新的 PHP 8.5 引擎:

sudo systemctl restart php-fpm

 

📝 总结

从旧版本升级到 PHP 8.5 整体流程利用 DNF 非常简单,主要的难点在于 PHP 8.5 将 Opcache 内置静态化 以及 JIT 与 Swoole 等扩展的互斥保护。只要清理掉旧的 .ini 缓存行并根据业务合理配置 opcache.jit=0,就能完美享受 PHP 8.5 带来的全新高效能!



免费获得每月10G空间+10G免费流量
Leave a Reply

*

*