执行pecl install mongodb提示无可用版本安装失败如何解决

报错原因 #

该报错通常是本地pecl缓存过期、源连接异常，或当前PHP版本与最新驱动不兼容导致。

修复步骤 #

• 第一步：更新pecl频道缓存
  执行以下命令更新本地的pecl包索引：
  pecl update-channels
  更新完成后重试pecl install mongodb即可，大部分场景下该操作可以直接解决问题。
• 第二步：指定兼容版本安装
  如果更新缓存后仍然报错，可以指定匹配自己PHP版本的稳定驱动版本安装，参考对应规则选择版本：
  • PHP 7.4 及以上版本可安装 1.12.x 及以上版本驱动
  • PHP 8.0 及以上版本可安装 1.13.x 及以上版本驱动
  • PHP 8.2 及以上版本建议安装 1.15.x 及以上版本驱动
    安装示例：
    pecl install mongodb-1.16.2
• 第三步：修复pecl源连接问题
  如果执行上述操作仍然失败，可以先执行pecl list-all验证是否能正常拉取包列表，如拉取失败可以更换为国内可用的pecl镜像源后重试。
• 第四步：手动编译安装（备选方案）
  如果pecl方式始终无法正常运行，可以直接下载驱动源码手动编译安装：
  1. 下载对应版本的mongodb驱动源码压缩包
  2. 解压后进入源码目录，依次执行以下命令：

  phpize
  ./configure
  make && make install
  

  3. 编译完成后编辑php.ini配置文件，添加extension=mongodb.so，重启PHP-FPM或者Web服务即可生效。

安装验证 #

安装完成后执行php -m | grep mongodb，如果返回mongodb就说明驱动安装成功，可以正常在Laravel项目中使用mongodb相关功能。

内容的提问来源于stack exchange，提问作者mj.akbarian