PHP - Manual: SoapClient

2025-10-31

SoapClient::__call »

« use_soap_error_handler

The SoapClient class

(PHP 5, PHP 7, PHP 8)

简介

The SoapClient class provides a client for » SOAP 1.1, » SOAP 1.2 servers. It can be used in WSDL or non-WSDL mode.

类摘要

class SoapClient {

/* 属性 */

private ?string $uri = null;

private ?int $style = null;

private ?int $use = null;

private ?string $location = null;

private bool $trace = false;

private ?int $compression = null;

private ?resource $sdl = null;

private ?resource $typemap = null;

private ?resource $httpsocket = null;

private ?resource $httpurl = null;

private ?string $_login = null;

private ?string $_password = null;

private bool $_use_digest = false;

private ?string $_digest = null;

private ?string $_proxy_host = null;

private ?int $_proxy_port = null;

private ?string $_proxy_login = null;

private ?string $_proxy_password = null;

private bool $_exceptions = true;

private ?string $_encoding = null;

private ?array $_classmap = null;

private ?int $_features = null;

private int $_connection_timeout;

private ?resource $_stream_context = null;

private ?string $_user_agent = null;

private bool $_keep_alive = true;

private ?int $_ssl_method = null;

private int $_soap_version;

private ?int $_use_proxy = null;

private array $_cookies = [];

private ?array $__default_headers = null;

private ?SoapFault $__soap_fault = null;

private ?string $__last_request = null;

private ?string $__last_response = null;

private ?string $__last_request_headers = null;

private ?string $__last_response_headers = null;

/* 方法 */

public __construct(?string $wsdl, array $options = [])

public __call(string $name, array $args): mixed

public __doRequest(
    string $request,
    string $location,
    string $action,
    int $version,
    bool $oneWay = false
): ?string

public __getCookies(): array

public __getFunctions(): ?array

public __getLastRequest(): ?string

public __getLastRequestHeaders(): ?string

public __getLastResponse(): ?string

public __getLastResponseHeaders(): ?string

public __getTypes(): ?array

public __setCookie(string $name, ?string $value = null): void

public __setLocation(?string $location = null): ?string

public __setSoapHeaders(SoapHeader|array|null $headers = null): bool

public __soapCall(
    string $name,
    array $args,
    ?array $options = null,
    SoapHeader|array|null $inputHeaders = null,
    array &$outputHeaders = null
): mixed

}

属性

__default_headers
__last_request
__last_request_headers
__last_response
__last_response_headers
__soap_fault
_classmap
_connection_timeout
_cookies
_digest
_encoding
_exceptions
_features
_keep_alive
_login
_password
_proxy_host
_proxy_login
_proxy_password
_proxy_port
_soap_version
_ssl_method
_stream_context
_use_digest
_use_proxy
_user_agent
compression
httpsocket
httpurl
location
sdl
style
trace
typemap
uri
use

SoapClient::__call — Calls a SOAP function (deprecated)
SoapClient::__construct — SoapClient constructor
SoapClient::__doRequest — Performs a SOAP request
SoapClient::__getCookies — Get list of cookies
SoapClient::__getFunctions — Returns list of available SOAP functions
SoapClient::__getLastRequest — Returns last SOAP request
SoapClient::__getLastRequestHeaders — Returns the SOAP headers from the last request
SoapClient::__getLastResponse — Returns last SOAP response
SoapClient::__getLastResponseHeaders — Returns the SOAP headers from the last response
SoapClient::__getTypes — Returns a list of SOAP types
SoapClient::__setCookie — Defines a cookie for SOAP requests
SoapClient::__setLocation — Sets the location of the Web service to use
SoapClient::__setSoapHeaders — Sets SOAP headers for subsequent calls
SoapClient::__soapCall — Calls a SOAP function

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 9 notes

down

hugues at zonereseau dot com ¶

14 years ago

When you need to connect to services requiring to send extra header use this method.


Here how we can to it with PHP and SoapClient


<?php

class exampleChannelAdvisorAuth

{

    public $DeveloperKey;

    public $Password;


    public function __construct($key, $pass)

    {

$this->DeveloperKey = $key;

$this->Password = $pass;

    }

}


$devKey        = "";

$password    = "";

$accountId    = "";


// Create the SoapClient instance

$url         = "";

$client     = new SoapClient($url, array("trace" => 1, "exception" => 0));


// Create the header

$auth         = new ChannelAdvisorAuth($devKey, $password);

$header     = new SoapHeader("http://www.example.com/webservices/", "APICredentials", $auth, false);


// Call wsdl function

$result = $client->__soapCall("DeleteMarketplaceAd", array(

"DeleteMarketplaceAd" => array(

"accountID"        => $accountId,

"marketplaceAdID"    => "9938745"        // The ads ID

)

), NULL, $header);


// Echo the result

echo "<pre>".print_r($result, true)."</pre>";

if($result->DeleteMarketplaceAdResult->Status == "Success")

{

    echo "Item deleted!";

}

?>

down

spam at kacke dot de ¶

2 years ago

In case a soap response returns nodes with the attribute xsi:nil="false", they are currently not processed by php-soapclient.

This seems to be a bug (not correct).

Workaround:

class mySoapClient extends SoapClient {
        public function __doRequest($request, $location, $action, $version, $one_way = 0) {
        $response = parent::__doRequest($request, $location, $action, $version, $one_way);
        $response = str_replace('xsi:nil="false"',"",$response);
        return $response;
    }    
}

Took me a day. Hope it can help
Toppi

down

Stefan ¶

10 years ago

There is a known bug with some versions of Xdebug which can cause SoapClient to not throw an exception but instead cause a fatal error. 

Surround the SoapClient call with xdebug_disable(); and xdebug_enable();  to work around this problem.

For reference:

http://bugs.xdebug.org/view.php?id=249
https://bugs.php.net/bug.php?id=47584

down

info at nospam x valiton x com ¶

9 years ago

CAUTION:
I had quite a bit of trouble trying to make a request with fopen through a proxy to a secure url.  I kept getting a 400 Bad Request back from the remote host.  It was receiving the proxy url as the SNI host.  In order to get around this I had to explicity set the SNI host to the domain I was trying to reach.  It's apparently the issue outlined in this bug:

https://bugs.php.net/bug.php?id=63519

<?php
$domain = parse_url($file, PHP_URL_HOST);
$proxy_string = "tcp://" . WP_PROXY_HOST  . ":" . WP_PROXY_PORT;
$opts = array( 
'http' => array( 'proxy' => $proxy_string ),
'ssl' => array( 'SNI_enabled' => true, 'SNI_server_name' => $domain));
$context = stream_context_create($opts);
$handle = fopen( $file, 'r', false, $context );
?>

src:
http://php.net/manual/en/context.http.php#114314

down

-1

Ricardo Pedrassani ¶

8 years ago

If the XML have identities with same name in different levels there is a solution. You don´t have to ever submit a raw XML (this PHP SOAP object don´t allows send a RAW XML), so you have to always translate your XML to a array, like the example below:

$originalXML = "
<xml>
  <firstClient>
      <name>someone</name>
      <adress>R. 1001</adress>
  </firstClient>
  <secondClient>
      <name>another one</name>
      <adress></adress>
  </secondClient>
</xml>"

//Translate the XML above in a array, like PHP SOAP function requires
$myParams = array('firstClient' => array('name' => 'someone',
                                  'adress' => 'R. 1001'),
            'secondClient' => array('name' => 'another one',
                                  'adress' => ''));

$webService = new SoapClient($someURL);
$result = $webService->someWebServiceFunction($myParams);

down

-1

peter dot hansen at fastit dot net ¶

15 years ago

When you get errors like:
"Fatal error: Uncaught SoapFault exception: [HTTP] Error Fetching http headers in" 
after a few (time intensive) SOAP-Calls, check your webserver-config. 

Sometimes the webservers "KeepAlive"-Setting tends to result in this error. For SOAP-Environments I recommend you to disable KeepAlive. 

Hint: It might be tricky to create a dedicated vhost for your SOAP-Gateways and disable keepalive just for this vhost because for normal webpages Keepalive is a nice speed-boost.

down

-3

acopantepuy at gmail dot com ¶

9 years ago

when they want to pass variables into the http header that is how it is done:

<?php

$aHTTP['http']['header'] =  "User-Agent: PHP-SOAP/5.5.11\r\n";

$aHTTP['http']['header'].= "username: XXXXXXXXXXX\r\n"."password: XXXXX\r\n";

$context = stream_context_create($aHTTP);

$client=new SoapClient("https://ocppws-cert.extra.bcv.org.ve:443/AltoValor/BancoUniversal?WSDL",array('trace' => 1,"stream_context" => $context));

$result = $client->jornadaActiva();
var_dump($result);
?>

down

-3

jjlopez ¶

13 years ago

If you are making soap calls in WSDL mode , and the address of your web service includes a port different from 80 (like http://my_ip_address:8080//service.asmx?wsdl), the WSDL file is fetched correctly, but all subsequent requests are made without any port in the host field. This causes a SoapFault exception when trying to call any of the service’s methods.

You need to redefine the soapClient class and force the port in each call.

See this example:

http://www.victorstanciu.ro/php-soapclient-port-bug-workaround/

down

-4

mcinantyspam at fejm dot pl ¶

8 years ago

Please note, that if you provide values that contain illegal xml characters (ASCII codes 0-8,  11-12, 14-15 - or x0-x8, xB-xC, xE-xF in hex), php's SoapClient will do send them in request, although such request is improper because it does not meet XML 1.0 requirements.
You always have to replace or remove these characters in your data before supplying them to SoapClient

＋添加备注

官方地址：https://www.php.net/manual/en/class.soapclient.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试数据库网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法正则表达式 Redis 互联网 MySql 软件运维 JavaScript 国际架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR MongoDB 运营 Python MemCache 商业硬件电子娱乐设计摄影 nginx WordPress 游戏 HTTP 团建数码电器 Docker

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦 ADOConnection 公用函数利用php soap实现web service adodb连接mysql多个数据库的问题 mysql面试题 php上周一、本周一、下周一日期 php 将字符串中的连续多个空格转换为一个空格 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP7添加redis扩展

略微加速

PHP官方手册 - 互联网笔记

The SoapClient class

简介

类摘要

属性

目录

发现了问题？

用户贡献的备注 9 notes