在PHP开发场景中，调用基于SOAP协议的第三方接口或者内部服务时，需要SoapClient类的支持，而该类属于PHP的SOAP扩展，默认情况下部分编译安装的PHP不会自动开启这个扩展，需要通过编译时加入with-soap参数来手动启用。
编译前的环境准备
在重新编译PHP之前，需要先确认系统已经安装了SOAP扩展所需的依赖库，不同系统的安装命令有所区别：
- CentOS/RHEL系统：执行
yum install -y libxml2-devel安装依赖 - Ubuntu/Debian系统：执行
apt-get install -y libxml2-dev安装依赖
如果缺少libxml2相关依赖，编译时会提示找不到xml相关的头文件，导致with-soap参数无法生效。
获取PHP源码并配置编译参数
首先需要根据当前使用的PHP版本下载对应的源码包，假设当前使用的是PHP7.4版本，操作流程如下：
# 下载PHP7.4源码包 wget https://www.php.net/distributions/php-7.4.33.tar.gz # 解压源码包 tar -zxvf php-7.4.33.tar.gz cd php-7.4.33 # 配置编译参数，加入--enable-soap参数（等价于with-soap的旧写法，新版本PHP统一用enable前缀） ./configure --prefix=/usr/local/php --enable-soap [其他你原本需要的编译参数]
需要注意的是，早期PHP版本的configure参数中使用的是--with-soap，新版本PHP已经统一调整为--enable-soap，如果执行configure时提示参数不存在，可以替换为新的参数名。配置过程中如果输出没有报错，说明参数生效，依赖检测通过。
执行编译与安装
配置完成后，执行编译和安装命令：
# 编译，-j参数后面跟CPU核心数，加快编译速度 make -j4 # 安装 make install
编译过程可能需要几分钟到十几分钟，取决于服务器性能，期间如果没有出现error级别的报错，就说明编译安装成功。
验证SoapClient是否开启成功
安装完成后，可以通过两种方式验证SoapClient支持是否生效：
方式一：通过phpinfo查看
创建测试文件info.php，内容如下：
<?php phpinfo();
在浏览器中访问该文件，搜索soap关键词，如果能看到SOAP扩展的相关信息，说明已经开启成功。
方式二：代码直接检测
创建测试文件check_soap.php，内容如下：
<?php
if (class_exists('SoapClient')) {
echo 'SoapClient支持已开启';
} else {
echo 'SoapClient支持未开启';
}
执行该脚本，如果输出SoapClient支持已开启，说明扩展已经正常工作。
常见问题与解决思路
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| configure时提示soap依赖缺失 | 未安装libxml2-devel依赖 | 根据系统类型安装对应的libxml2开发包 |
| 编译时报soap相关错误 | PHP版本和参数不匹配 | 确认使用的参数是--enable-soap还是--with-soap，替换对应参数 |
| 安装后phpinfo看不到soap扩展 | 配置文件未加载扩展 | 检查php.ini中是否存在extension=soap.so配置，不存在则添加后重启PHP服务 |
如果是通过包管理器安装的PHP，也可以直接安装对应的soap扩展包，比如Ubuntu系统可以执行apt-get install -y php7.4-soap直接安装，不需要重新编译PHP，但如果是需要自定义PHP编译参数，或者使用的PHP版本没有对应的包，编译时加入with-soap相关参数是最可靠的开启方式。
PHPSoapClientwith-soap编译安装修改时间：2026-06-15 05:57:25