PHP SoapClient调用同名SOAP方法：如何指定目标方法？

这个问题我之前对接SOAP服务时也碰到过——当SOAP服务存在同名但参数不同的重载方法时，WSDL通常会自动给这些方法加上后缀（比如你看到的CreateNewContact_FullName和CreateNewContact_FirstLastName），而PHP SoapClient不会自动根据参数数量去匹配对应的方法，直接调用CreateNewContact就容易出现匹配错误的情况。

下面是几个可行的解决方案：

1. 直接调用WSDL中实际的方法名 #

这是最直接有效的方式，既然SOAP UI已经显示了两个方法的实际名称，你可以直接用这个名称调用：

// 初始化SoapClient
$soapClient = new SoapClient('http://test.com/testWebservice/?wsdl');

// 准备4个参数的数组
$contactParams = [
    'firstName' => 'Jane',
    'lastName' => 'Smith',
    'email' => 'jane.smith@example.com',
    'telNo' => '0987654321'
];

// 直接调用带后缀的方法名
$response = $soapClient->CreateNewContact_FirstLastName($contactParams);

这样就能精准定位到你需要的4参数方法，避免和3参数的方法混淆。

2. 使用__soapCall方法指定操作名 #

如果你的代码里已经习惯用CreateNewContact这个名称，或者需要更灵活的调用方式，可以用SoapClient的__soapCall方法，显式指定要调用的操作名：

$soapClient = new SoapClient('http://test.com/testWebservice/?wsdl');

$contactParams = [
    'firstName' => 'Jane',
    'lastName' => 'Smith',
    'email' => 'jane.smith@example.com',
    'telNo' => '0987654321'
];

// 显式指定要调用的方法名
$response = $soapClient->__soapCall(
    'CreateNewContact_FirstLastName', // 实际操作名
    [$contactParams] // 参数数组
);

如果WSDL中定义了对应的SOAPAction，你还可以加上第三个参数来进一步确保准确性：

$soapOptions = [
    'soapaction' => 'http://test.com/testWebservice/CreateNewContact_FirstLastName'
];

$response = $soapClient->__soapCall(
    'CreateNewContact_FirstLastName',
    [$contactParams],
    $soapOptions
);

3. 先确认WSDL中的所有方法签名 #

如果你不确定WSDL里实际暴露的方法名，可以用__getFunctions()方法打印出所有可用的方法：

$soapClient = new SoapClient('http://test.com/testWebservice/?wsdl');
print_r($soapClient->__getFunctions());

输出结果会显示每个方法的完整签名，包括参数和返回值，你可以从中找到准确的方法名称来调用。

总结 #

SOAP本身并不支持方法重载，所以服务端会通过重命名方法来区分不同参数的版本。PHP SoapClient无法自动根据参数数量匹配对应的重载方法，因此必须直接使用WSDL中定义的唯一方法名，或者通过__soapCall显式指定操作名，才能确保调用到正确的方法。

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