SoapClient::__call

(PHP 5, PHP 7, PHP 8)

SoapClient::__call — Chama uma função SOAP (descontinuada)

Descrição

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

Chamar este método diretamente foi descontinuado. Em vez disso, recomenda-se a utilização das funções SOAP como métodos do objeto SoapClient. No entanto, em alguns casos pode ser necessário utilizar opções adicionais ou chamar funções com nomes dinâmicos, e nesses casos é recomendado utilizar o método SoapClient::__soapCall(). Este último permite um controle mais detalhado sobre a chamada da função, incluindo a especificação do nome da função como uma string.

Parâmetros

name: O nome da função SOAP a ser chamada.
args: Ao chamar uma função SOAP, é necessário passar os argumentos adequados para que a operação seja executada corretamente. Esses argumentos são fornecidos como um array, que pode ser organizado de duas formas distintas: array indexado (também conhecido por "array ordenado") ou array associativo. É importante notar que muitos servidores SOAP requerem que os nomes dos parâmetros sejam fornecidos na chamada da função. Nesse caso, é necessário utilizar um array associativo para garantir que cada valor seja atribuído ao parâmetro correto.

Valor Retornado

Funções SOAP podem retornar um ou vários valores. Caso a função retorne apenas um valor, tratar-se-á um valor escalar. Se vários valores forem retornados, em vez disso, será retornado um array associativo de parâmetros de saída nomeados. Já no caso de retornar múltiplos valores, tratar-se-á de um array associativo de parâmetros de saída nomeados.

Ao ocorrer um erro durante a execução de uma operação SOAP, o objeto SoapClient poderá retornar um objeto SoapFault para indicar o problema. No entanto, vale referir que esse comportamento depende da opção exceptions, sendo que esta pode ser configurada no momento que o objecto é instanciado. Caso ocorra um erro e essa opção esteja definida como false, a biblioteca do PHP não lançará uma exceção.

add a note

User Contributed Notes 4 notes

down

philipp dot gruber at catchoftheday dot com dot au ¶

10 years ago


If you are using a WSDL, the library will strip out anything from your parameters that is not defined in WSDL, without giving you any notice about this.

So if your parameters are not fully matching the WSDL, it will simply send no parameters at all.
This can be a bit hard to debug if you don't have access to the target server.

__soapCall() expects parameters in an array called 'parameters' as opposed to calling the function via it's WSDL name, where it accepts the parameters as a plain array.

I.e. if a function called sendOrder expects a parameter (array) called orderDetails, you can call it like this:

$orderDetails = array(/* your data */);
$soap->sendOrder(array('orderDetails' => $orderDetails));

Which is equivalent to:

$client->__soapCall('sendOrder', array('parameters' => array('orderDetails' => $orderDetails)));

Note the additional 'parameters' key used in __soapCall().

down

KRavEN ¶

15 years ago


extend of __call thats adds a retry to handle the occasional 'Could not connect to host' exceptions

<?php
class LocalSoapClient extends SoapClient
{

  public function __call($function_name, $arguments)
  {
    $result = false;
    $max_retries = 5;
    $retry_count = 0;
    
    while(! $result && $retry_count < $max_retries)
    {
      try
      {
        $result = parent::__call($function_name, $arguments);
      }
      catch(SoapFault $fault)
      {
        if($fault->faultstring != 'Could not connect to host')
        {
          throw $fault;
        }
      }
      sleep(1);
      $retry_count ++;
    }
    if($retry_count == $max_retries)
    {
      throw new SoapFault('Could not connect to host after 5 attempts');
    }
    return $result;
  }
}
?>

down

-13

bananos at dev dot co dot ua ¶

16 years ago


I'm writing PHP SOAP client (based on php_soap extension) which uses Google AdService, 
today, I tried to create sample Ad using   AdService::addAds()  and discovered that my SOAP library does not pass 
"headline", "description1", "description2"  parameters in SOAP request. 

First, I thought that this was something wrong with my data, coz I was getting validation errors like 
"One or more input elements failed validation."   Then I decided to take a look at WSDL description 
https://adwords.google.com/api/adwords/v11/AdService?wsdl

And voilà !  I've found this:

<complexType name="Ad" abstract="true">
<sequence>
  <element name="adGroupId" type="xsd:int"/>
  <element name="adType" nillable="true" minOccurs="0" type="impl:AdType"/>
  <element name="destinationUrl" nillable="true" minOccurs="0" type="xsd:string"/>
  <element name="disapproved" type="xsd:boolean"/>
  <element name="displayUrl" nillable="true" minOccurs="0" type="xsd:string"/>
  <element name="exemptionRequest" nillable="true" minOccurs="0" type="xsd:string"/>
  <element name="id" type="xsd:long"/>
  <element name="status" nillable="true" minOccurs="0" type="impl:AdStatus"/>
</sequence>

</complexType>

There is no any ''description", "headline1", "headline2", however there is another complexType 

<complexType name="TextAd">
    <complexContent>
    <extension base="impl:Ad">
    <sequence>

<element name="description1" nillable="true" type="xsd:string"/>
<element name="description2" nillable="true" type="xsd:string"/>
<element name="headline" nillable="true" type="xsd:string"/>
</sequence>

</extension>
</complexContent>
</complexType>

So, the thing is when you are working with php_soap be aware of complexType extensions which does not work in php_soap when you try to do things like:

<?php

$client = new
    SoapClient(
       "https://adwords.google.com/api/adwords/v11/AdService?wsdl",
        array(  'trace'      => true,
                'exceptions' => true,
             )
      
    );

$entropy     = substr(md5(rand(0, time())), 0, 10);
//create Ad test structure
$sample_ad =  array(
               "id" => 0,
               "adGroupId" => 0,
               "adType" => 'TextAd',
               "disapproved" => false,
               "destinationUrl" => 'http://test.com',
               "displayUrl" => 'www.Test.com',
               "status" => "Paused", //  Enabled / Disabled
               "descr_iption1" => 'D1_'.$entropy,
               "des_cription2" => 'D2_'.$entropy,
               "head_line" => 'H_'.$entropy
        );

$client->addAds(array('ads' => array($sample_ad) );
?>

down

-23

Samil Abud ¶

17 years ago


Hi,
This is a good example, for the SOAP function "__call".
However it is deprecated.

<?php
$wsdl = "http://webservices.tekever.eu/ctt/?wsdl";
$int_zona = 5;
$int_peso = 1001;
$cliente = new SoapClient($wsdl);
print "<p>Envio Internacional: ";
$vem = $cliente->__call('CustoEMSInternacional',array($int_zona, $int_peso));
print $vem;
print "</p>";
?>

add a note