PHP8.3 升级 PHP8.4 移除扩展要怎么替代-php教程-PHP中文网

PHP 8.4 已硬性移除 Pspell、IMAP、OCI8 和 PDO_OCI 四个内置扩展，需通过 PECL 或 ondrej/php PPA 安装，并为 OCI8/PDO_OCI 配置 Oracle Instant Client。

php8.3 升级 php8.4 移除扩展要怎么替代

PHP 8.4 已将四个原本内置的核心扩展正式移出 PHP 源码，改为仅通过 PECL 提供：Pspell、IMAP、OCI8 和 PDO_OCI。这不是“弃用”，而是硬性移除——安装完 PHP 8.4 后，这些扩展默认不存在，调用相关函数（如 imap_open()、oci_connect()）会直接报 Fatal error: Uncaught Error: Call to undefined function。

确认哪些扩展被移除了

被移除的是以下四个扩展：

Pspell：拼写检查（pspell_* 函数）
IMAP：邮件协议访问（imap_open()、imap_fetchbody() 等）
OCI8：Oracle 数据库连接（oci_connect()、oci_parse()）
PDO_OCI：PDO 的 Oracle 驱动（new PDO('oci:...', ...)）

注意：PDO_MYSQL、PDO_PGSQL、mysqli、pgsql 等常用扩展仍保留在核心中，不受影响。

替代方案：统一通过 PECL 安装

所有被移出的扩展，现在都由官方 PECL 项目维护，安装方式一致：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

确保已安装 php-dev 和对应系统依赖（如 libpq-dev、libicu-dev、Oracle Instant Client SDK 等）
使用 pecl install 命令安装（需匹配当前 PHP 版本）：
sudo pecl install imap
sudo pecl install oci8
sudo pecl install pdo_oci
sudo pecl install pspell
安装成功后，PECL 会提示添加扩展行到 php.ini（如 extension=imap.so），务必手动确认并重启服务

Ubuntu/Debian 用户更推荐用 ondrej/php PPA 安装预编译包

相比手动编译 PECL，PPA 提供了稳定、版本对齐的二进制包，更适合生产环境：

先确保已添加源：sudo add-apt-repository ppa:ondrej/php && sudo apt update
安装对应扩展包（注意命名规则）：
sudo apt install php8.4-imap
sudo apt install php8.4-oci8
sudo apt install php8.4-pdo-oci
sudo apt install php8.4-pspell
无需手动编辑 php.ini，模块自动启用；但需验证：php -m | grep imap