PHP 8.1 升级到 8.3 后扩展缺失主因是 ABI 不兼容、配置未同步及依赖版本过低；需分别验证 CLI/Web 环境配置路径，用 PHP 8.3 对应 phpize 和头文件重装扩展，并升级 libzip ≥ 1.8.0、检查 ZEND_MODULE_API_NO 匹配。
PHP 8.1 升级到 8.3 后出现扩展缺失，不是“丢了”，而是扩展未重新适配新版本——PHP 每次大版本升级（尤其 8.1 → 8.3）都会变更 ABI（Module API）编号、移除废弃函数、收紧类型检查，并可能调整扩展依赖关系。直接沿用旧扩展的 .so 文件或旧配置，90% 会失效。
下面分三类典型情况，给出可立即执行的处理路径：
确认是否真“缺失”：先区分 CLI 和 Web 环境
同一台服务器上，php -m 显示有 zip，但网页里 class_exists('ZipArchive') 返回 false？
这说明 CLI 和 PHP-FPM（或 Apache mod_php）加载的是不同版本的 PHP 实例和配置。
先运行这三条命令，比对结果：
-
which php→ 查 CLI 的二进制路径（如/usr/bin/php8.3） -
php --ini→ 查 CLI 实际读取的php.ini及conf.d/ -
php-fpm8.3 -t && sudo systemctl restart php8.3-fpm后，在网页中访问<?php phpinfo(); ?>，搜索 “Loaded Configuration File”
⚠️ 常见陷阱：apt install php8.3-zip 安装的扩展只写入 /etc/php/8.3/cli/conf.d/ 和 /etc/php/8.3/fpm/conf.d/，但如果你的 php-fpm8.3 实际调用的是 /etc/php/8.2/fpm/php.ini，那 .ini 就根本没生效。
扩展因 ABI 不兼容而加载失败
报错形如：PHP Warning: PHP Startup: Cannot load module 'redis' because it was compiled with module API=20210902 while PHP was compiled with module API=20230831
立即学习“PHP免费学习笔记（深入）”；
这是最典型的版本断层。PHP 8.3 的 ABI 编号是 20230831（以实际 php -i | grep "PHP Extension" 输出为准），所有扩展必须用 PHP 8.3 的头文件和 phpize 重新编译。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
操作步骤（Ubuntu/Debian）：
- 卸载旧扩展：
sudo apt remove php8.1-redis php8.1-zip（避免冲突） - 安装新版开发包：
sudo apt install php8.3-dev libzip-dev pkg-config - 清理并重装扩展：
sudo pecl uninstall redis zip sudo pecl install redis zip
- 确保生成的
.so文件被写入正确的extension_dir（如/usr/lib/php/20230831/），且对应php.ini中有：extension_dir = "/usr/lib/php/20230831" extension=redis.so extension=zip.so
✅ 验证 ABI 是否匹配：
php -r "echo PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION.'.'.PHP_RELEASE_VERSION; echo ' → ABI '.ZEND_MODULE_API_NO;"
扩展功能异常但无报错：PHP 8.3 的静默行为变更
有些扩展“加载成功”，却在运行时报错或返回错误结果，例如：
-
ZipArchive::open()返回ZIPARCHIVE::ER_OPEN（即使文件存在且可读）→ 因底层libzip版本过低（PHP 8.3 要求 ≥ 1.8.0，推荐 1.10.0+） -
mb_convert_encoding()报mbstring不支持某编码 →php8.3-mbstring包默认不启用--enable-mbregex，需手动编译或换用php8.3-mbstring的完整版
关键检查项：
-
pkg-config --modversion libzip→ 若 -
php -r "echo defined('MB_CASE_TITLE') ? 'OK' : 'MISSING';"→ 验证 mbstring 功能完整性 -
php -r "echo ZIPARCHIVE::CHECKSUM_CRC32;"→ 若报错，说明 libzip 不支持该特性，ZipArchive 功能受限
不复杂但容易忽略
