PHP raphf扩展2.0.1适配PHP8.2启动失败求助

问题概述 #

安装Windows版本raphf 2.0.1扩展以配合php_http扩展使用时，启动PHP出现版本兼容错误：

PHP Startup: raphf: Unable to initialize module
Module compiled with module API=20210902
PHP    compiled with module API=20220829

尽管raphf文档宣称支持PHP 7.0+，但当前找不到适配PHP 8.2（Module API 20220829）的预编译.dll文件，且需http扩展来安装swagger bundle。

解决方法 #

1. 寻找对应API版本的预编译扩展包 #

• 确认你的PHP 8.2是线程安全（TS）/非线程安全（NTS）、x86/x64架构以及使用的VC版本（比如VC16）
• 筛选提供Windows预编译PHP扩展的仓库，找到raphf和pecl_http扩展中编译API为20220829的版本下载
• 替换现有ext目录下的.dll文件，更新php.ini中的扩展配置后重启PHP环境

2. 手动编译适配版本 #

如果找不到预编译包，可手动编译：

• 下载PHP 8.2源码、raphf最新源码，安装对应PHP编译VC版本的Visual Studio和Windows SDK
• 打开VS命令提示符，进入raphf源码目录，运行phpize生成编译配置
• 执行configure --enable-raphf，再执行nmake编译生成.dll文件
• 将编译好的.dll放入ext目录并配置php.ini

3. 替代方案：改用Guzzle HTTP客户端 #

pecl_http并非swagger bundle的唯一依赖选择，可改用更普及的Guzzle扩展：

• 通过Composer安装guzzlehttp/guzzle
• 配置swagger bundle使用Guzzle作为HTTP客户端，绕过对pecl_http和raphf的依赖

内容的提问来源于stack exchange，提问作者iHateGrapes