RHEL 8 下正确安装 PHP mcrypt 扩展的完整指南

rhel 8 已移除对 libmcrypt 的原生支持，无法直接通过 dnf 安装源码包；应使用 pecl 结合 epel 提供的开发依赖编译安装 mcrypt php 扩展。

rhel 8 已移除对 libmcrypt 的原生支持，无法直接通过 dnf 安装源码包；应使用 pecl 结合 epel 提供的开发依赖编译安装 mcrypt php 扩展。

在 RHEL 8 中，libmcrypt 已被正式弃用，系统仓库（BaseOS/AppStream）不再提供 libmcrypt 或其开发包，因此尝试用 dnf install /tmp/libmcrypt-2.5.8.tar.gz 这类命令必然失败——dnf 只能安装 RPM 包（如 .rpm），不支持直接安装 .tar.gz 源码压缩包，这也是报错 Unable to find a match 的根本原因。

此外，mcrypt-1.0.4 并非独立应用，而是 PHP 的 PECL 扩展模块，必须通过 pecl 工具配合 PHP 开发环境编译安装，而非手动解压构建 libmcrypt 库本身。

✅ 正确安装路径如下（以 root 或具有 sudo 权限的用户执行）：

1. 启用 EPEL 仓库（必需）

sudo dnf install -y epel-release sudo dnf update -y

2. 安装编译依赖

sudo dnf install -y php-devel libmcrypt-devel php-pear gcc make

⚠️ 注意：libmcrypt-devel 在 RHEL 8 的 EPEL 仓库中仍可获取（版本为 2.5.8），它提供了 mcrypt.h 等头文件，是 pecl install mcrypt 成功编译的前提。

立即学习“PHP免费学习笔记（深入）”；

3. 使用 PECL 编译安装 mcrypt 扩展

sudo pecl install mcrypt

执行过程中会自动下载 mcrypt-1.0.4 源码、调用 phpize 和 gcc 编译，并将生成的 mcrypt.so 输出至标准 PHP 模块目录（如 /usr/lib64/php/modules/）。

4. 启用扩展并验证

编辑 PHP 配置（通常为 /etc/php.d/ 下新建配置）：

echo "extension=mcrypt.so" | sudo tee /etc/php.d/20-mcrypt.ini

重启 Web 服务（如 apache 或 PHP-FPM）：

sudo systemctl restart httpd    # 或 php-fpm

验证是否加载成功：

php -m | grep mcrypt   # 应输出 mcrypt php -i | grep "mcrypt support"  # 应显示 enabled

? 重要提醒：

• mcrypt 扩展自 PHP 7.2 起已被标记为废弃（deprecated），PHP 7.3+ 完全移除。RHEL 8 默认附带 PHP 7.4 或 8.x，强烈建议迁移到现代加密方案（如 OpenSSL 扩展的 openssl_encrypt()/openssl_decrypt()），而非依赖已淘汰的 mcrypt。
• 若因遗留系统必须使用，请确保 PHP 版本 ≤ 7.2，或在兼容环境中（如容器）隔离部署。

? 补充说明：若 pecl install mcrypt 报错缺少 autoconf，请额外安装：

sudo dnf install -y autoconf

遵循以上步骤，即可在 RHEL 8 上合规、稳定地启用 mcrypt 扩展——关键在于理解其“PECL 扩展”本质，而非误当作系统库处理。