PHP调用SOAP服务需启用soap扩展，通过SoapClient类加载WSDL文件，分析接口方法与参数结构，构造请求数据并调用远程方法，支持复杂参数、命名空间及自定义Header，结合异常处理与调试功能完成交互。

PHP调用SOAP服务（即WebService）主要依赖内置的 SoapClient 类。整个流程包括环境准备、WSDL分析、参数构造、调用与错误处理等步骤。下面详细介绍完整的实现过程。

1. 确认PHP环境支持SOAP扩展

在使用SOAP之前，必须确保PHP已启用soap扩展。

• 创建一个PHP文件，写入 phpinfo(); 查看是否有“soap”模块信息
• 或运行命令行：php -m | grep soap

• 编辑 php.ini 文件，去掉 extension=soap 前面的分号

• 重启Web服务器或PHP-FPM

2. 获取并分析WSDL文件

WSDL（Web Services Description Language）是描述WebService接口结构的XML文件，包含方法名、参数、返回值等信息。

• 通常服务提供方会给出WSDL地址，例如：http://example.com/service.wsdl
• 浏览器访问该地址可查看接口定义
• 重点关注 和对应的输入输出消息

3. 使用SoapClient调用服务

实例化 SoapClient 并调用远程方法。

try {
    $client = new SoapClient('http://example.com/service.wsdl', [
        'trace' => true,       // 开启调试
        'exceptions' => true,  // 抛出异常
        'cache_wsdl' => WSDL_CACHE_NONE // 关闭缓存，开发时建议开启
    ]);

    // 构造请求参数（根据WSDL要求）
    $params = [
        'userId' => 12345,
        'token' => 'abc123'
    ];

    // 调用方法
    $result = $client->getUserInfo($params);

    // 输出结果
    var_dump($result);
} catch (SoapFault $e) {
    echo "调用失败：" . $e->getMessage();
}

4. 处理复杂参数和命名空间

某些服务需要传递嵌套结构或指定命名空间。

• 参数可以是关联数组，对应SOAP中的对象结构
• 若需自定义Header（如认证Token），可使用 __setSoapHeaders()

$auth = [
    'Username' => 'your_username',
    'Password' => 'your_password'
];
$header = new SoapHeader('http://example.com/auth', 'Auth', $auth);
$client->__setSoapHeaders($header);

5. 调试与常见问题

开启 trace 后可用以下方法查看请求细节：

• $client->__getLastRequest()：查看发送的XML
• $client->__getLastResponse()：查看返回的XML
• 注意编码问题，确保传输为UTF-8
• 部分服务不提供WSDL，需使用非WSDL模式：

$client = new SoapClient(null, [
    'location' => 'http://example.com/soap-endpoint',
    'uri'      => 'http://example.com/namespace',
    'trace'    => 1
]);
$client->__soapCall('methodName', [$params]);