Edit Report a Bug

SoapClient::__setSoapHeaders

(PHP 5 >= 5.0.5, PHP 7, PHP 8)

SoapClient::__setSoapHeaders — Ajoute un en-tête SOAP pour les requêtes suivantes

Description

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

Définit un en-tête à utiliser dans les requêtes SOAP.

Note:
Cette méthode va remplacer la valeur précédente.

Liste de paramètres

headers: L'en-tête à configurer. Il peut être un objet SoapHeader ou un tableau d'objetcs SoapHeader. Si ce paramètre n'est pas spécifié ou défini à null, les en-têtes seront supprimés.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec SoapClient::__setSoapHeaders()

<?php

$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
                                     'uri'      => "http://test-uri/"));
$header = new SoapHeader('http://soapinterop.org/echoheader/', 
                            'echoMeStringRequest',
                            'hello world');

$client->__setSoapHeaders($header);

$client->__soapCall("echoVoid", null);
?>

Exemple #2 Configuration d'en-têtes multiples pour SOAP

<?php

$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
                                     'uri'      => "http://test-uri/"));
$headers = array();

$headers[] = new SoapHeader('http://soapinterop.org/echoheader/', 
                            'echoMeStringRequest',
                            'hello world');

$headers[] = new SoapHeader('http://soapinterop.org/echoheader/', 
                            'echoMeStringRequest',
                            'hello world again');

$client->__setSoapHeaders($headers);

$client->__soapCall("echoVoid", null);
?>

add a note

User Contributed Notes 4 notes

down

kedar dot purohit @ mavs dot uta dot edu ¶

15 years ago


To create complex SOAP Headers, you can do something like this:



Required SOAP Header:



<soap:Header>

    <RequestorCredentials xmlns="http://namespace.example.com/">

      <Token>string</Token>

      <Version>string</Version>

      <MerchantID>string</MerchantID>

      <UserCredentials>

        <UserID>string</UserID>

        <Password>string</Password>

      </UserCredentials>

    </RequestorCredentials>

</soap:Header>



Corresponding PHP code:



<?php



$ns = 'http://namespace.example.com/'; //Namespace of the WS.



//Body of the Soap Header.

$headerbody = array('Token' => $someToken,

                    'Version' => $someVersion,

                    'MerchantID'=>$someMerchantId,

                      'UserCredentials'=>array('UserID'=>$UserID,

                                             'Password'=>$Pwd));



//Create Soap Header.        

$header = new SOAPHeader($ns, 'RequestorCredentials', $headerbody);        

        

//set the Headers of Soap Client.

$soap_client->__setSoapHeaders($header);



?>

down

peamik1953 at NOSPAM dot btinternet dot com ¶

14 years ago


You cannot add an additional header. If you want two headers, and one already exists, first delete it with $client->__setSoapHeaders(NULL). Then issue $client->__setSoapHeaders($headers) where $headers is an array of soapHeader() objects.

down

jayrajput at gmail dot com ¶

15 years ago


With multiple SOAP headers, when using SoapVar for creation of SoapHeader the PHP code just terminates (command terminated). I am not sure if that is a bug. 



Without the SOAPVar the code worked fine for me



There are different way to creart SoapHeader I was using SoapVar and the code was not working. I am still a novice with this SOAP stuff.



Tried using normal strings and it worked fine. SoapHeader can take SoapVar or string as the third argument.



my code:



<?php

// first soap header.

$var = new SoapVar($header, XSD_ANYXML);

$soapHeader = new SoapHeader(NAME_SPACE, "Security", $var);

// second soap header.

$var2 = new SoapVar($header2, XSD_ANYXML);

$soapHeader2 = new SoapHeader(DIFF_NAME_SPACE, "ID", $var2);



$client = new SoapClient($wsdl, array("location" => $location));



$headers = array();

$headers[] = $soapHeader;

$headers[] = $soapHeader2;



// Here my code was just terminating.

$client->__setSoapHeaders($headers);

?>

down

-10

mlconnor at yahoo dot com ¶

13 years ago


Does anyone know how to get the response headers?  The getLastResponseHeader returns a string response, not the complex object I was expecting...

add a note