PHP 8.1+ 必须用 mongodb 扩展，mongo 扩展已彻底废弃；pecl install mongo 报错因该命令自 PHP 7.4 起失效，且系统缺少 OpenSSL 开发头文件（如 libssl-dev 或 openssl-devel），导致 configure 阶段失败。
PHP 8.1+ 必须用 mongodb 扩展，mongo 扩展已彻底废弃；SSL 库缺失或版本不匹配，是安装失败最常见原因，不是网络或权限问题。
为什么 pecl install mongo 会报错？
该命令在 PHP 7.4 之后就失效了：mongo 扩展早在 2018 年停止维护，PHP 8.0 起完全移除。你现在看到的错误（如 ERROR: failed to download 或 configure: error: cannot find ssl headers）基本都源于两个事实：你试图装旧扩展，且系统缺少 OpenSSL 开发头文件。
-
pecl install mongo→ 永远失败，别试 - 正确命令是
pecl install mongodb - 但执行前必须确保
libssl-dev（Debian/Ubuntu）或openssl-devel（CentOS/RHEL）已安装，否则./configure阶段直接退出
SSL 依赖缺失的具体表现和修复
典型错误信息：configure: error: Cannot find OpenSSL's 或 fatal error: openssl/ssl.h: No such file or directory。这不是 OpenSSL 运行时库没装（openssl 命令能运行就行），而是开发包（含头文件和静态链接库）没装。
- Ubuntu/Debian：
sudo apt install libssl-dev libsasl2-dev - CentOS/RHEL 8+：
sudo dnf install openssl-devel cyrus-sasl-devel - CentOS/RHEL 7：
sudo yum install openssl-devel cyrus-sasl-devel - 装完验证：
pkg-config --modversion openssl应返回版本号（如1.1.1f）
PHP 版本、架构与扩展的硬匹配规则
PECL 安装看似自动，但底层仍依赖 phpize 和 php-config 的输出。若你用的是自编译 PHP（比如装在 /usr/local/php），而系统默认的 phpize 是系统包管理器装的 PHP 提供的，就会因 ABI 不兼容导致扩展加载失败（PHP Warning: PHP Startup: Unable to load dynamic library 'mongodb.so'）。
- 先确认当前 CLI 使用的 PHP 路径：
which php - 再确认
php-config是否匹配：/path/to/your/php/bin/php-config --version应和php -v一致 - 手动编译时必须指定：
./configure --with-php-config=/path/to/your/php/bin/php-config - PECL 安装时若提示
Cannot find autoconf，说明缺构建工具：sudo apt install autoconf build-essential（Ubuntu）或sudo dnf groupinstall "Development Tools"（RHEL）
装完后 extension 加载失败的排查点
即使 pecl install mongodb 显示 success，php -m | grep mongo 仍为空，大概率是以下三个环节之一断了：
-
extension_dir路径写错：用php -i | grep extension_dir确认实际路径，不要抄网上示例的/usr/lib/php/20220829这类过期值 -
extension=mongodb.so这行没加到**生效的 php.ini** 中：运行php --ini查看 Loaded Configuration File，编辑那个文件，不是/etc/php/*/cli/php.ini就一定是/etc/php/*/apache2/php.ini - 扩展名写错：PHP 7.4+ 统一叫
mongodb.so，不是mongo.so，也不是php_mongodb.so
最易被忽略的是：Web 服务器（Apache/Nginx）和 CLI 使用的是两套 php.ini，改完必须分别重启服务和检查 phpinfo() 页面，不能只信 php -m。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
