Php soapclient обработка ошибок

UPDATE July 2018

If you don’t care about getting the SoapFault details and just want to catch any errors coming from the SoapClient you can catch «Throwable» in PHP 7+. The original problem was that SoapClient can «Fatal Error» before it throws a SoapFault so by catching both errors and exceptions with Throwable you will have very simple error handling e.g.

try{
    soap connection...
}catch(Throwable $e){
    echo 'sorry... our service is down';
}

If you need to catch the SoapFault specifically, try the original answer which should allow you to suppress the fatal error that prevents the SoapFault being thrown

Original answer relevant for older PHP versions

SOAP can fatal error calling the native php functions internally which prevents the SoapFaults being thrown so we need to log and suppress those native errors.

First you need to turn on exceptions handling:

try {
    $client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
       'exceptions' => true,
    ));
} catch ( SoapFault $e ) { // Do NOT try and catch "Exception" here
    echo 'sorry... our service is down';
}

AND THEN you also need to silently suppress any «PHP errors» that originate from SOAP using a custom error handler:

set_error_handler('handlePhpErrors');
function handlePhpErrors($errno, $errmsg, $filename, $linenum, $vars) {
    if (stristr($errmsg, "SoapClient::SoapClient")) {
         error_log($errmsg); // silently log error
         return; // skip error handling
    }
}

You will then find it now instead trips a SoapFault exception with the correct message «Soap error: SOAP-ERROR: Parsing WSDL: Couldn’t load from ‘…'» and so you end up back in your catch statement able to handle the error more effectively.

ОБНОВЛЕНИЕ июль 2018

Если вы не хотите получать информацию о SoapFault и просто хотите отловить любые ошибки, исходящие от SoapClient, вы можете отловить «Throwable» в PHP 7+. Первоначальная проблема заключалась в том, что SoapClient может «фатальная ошибка» до того, как выдаст SoapFault, поэтому, перехватывая как ошибки, так и исключения с помощью Throwable, вы будете иметь очень простую обработку ошибок, например

try{
    soap connection...
}catch(Throwable $e){
    echo 'sorry... our service is down';
}

Если вам нужно конкретно поймать SoapFault, попробуйте исходный ответ, который должен позволить вам подавить фатальную ошибку, которая предотвращает выброс SoapFault.

Оригинальный ответ, актуальный для более старых версий PHP

SOAP может вызвать фатальную ошибку при вызове собственных функций php внутри, что предотвращает создание SoapFaults, поэтому нам необходимо регистрировать и подавлять эти собственные ошибки.

Сначала нужно включить обработку исключений:

try {
    $client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
       'exceptions' => true,
    ));
} catch ( SoapFault $e ) { // Do NOT try and catch "Exception" here
    echo 'sorry... our service is down';
}

И ТОГДА вам также нужно молча подавить любые «ошибки PHP», исходящие из SOAP, с помощью специального обработчика ошибок:

set_error_handler('handlePhpErrors');
function handlePhpErrors($errno, $errmsg, $filename, $linenum, $vars) {
    if (stristr($errmsg, "SoapClient::SoapClient")) {
         error_log($errmsg); // silently log error
         return; // skip error handling
    }
}

Затем вы обнаружите, что теперь он вместо этого отключает исключение SoapFault с правильным сообщением «Ошибка мыла: SOAP-ERROR: Анализ WSDL: не удалось загрузить из ‘…’», и поэтому вы вернетесь в свой оператор catch, способный обрабатывать ошибка более эффективно.

5 ответов

$handle = curl_init($url);
curl_setopt($handle,  CURLOPT_RETURNTRANSFER, TRUE);

$response = curl_exec($handle);
$httpCode = curl_getinfo($handle, CURLINFO_HTTP_CODE);
if($httpCode == 404) {
    /* You don't have a WSDL Service is down. exit the function */
}

curl_close($handle);

/* Do your stuff with SOAP here. */

try {
    $client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
       'exceptions' => true,
    ));
} catch ( SoapFault $e ) { // Do NOT try and catch "Exception" here
    echo 'sorry... our service is down';
}

set_error_handler('handlePhpErrors');
function handlePhpErrors($errno, $errmsg, $filename, $linenum, $vars) {
    if (stristr($errmsg, "SoapClient::SoapClient")) {
         error_log($errmsg); // silently log error
         return; // skip error handling
    }
}

$client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
    'exceptions' => false,    // change to true so it will throw an exception
));

try {
  $client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
    'exceptions' => true,
  ));
}
catch ( Exception $e )
{
    echo 'sorry... our service is down';
}

set_error_handler('my_error_handler');
set_exception_handler('my_exception_handler');

function my_exception_handler($e) {
    exit('Error, something went terribly wrong: '.$e);
}

function my_error_handler($no,$str,$file,$line) {
    $e = new ErrorException($str,$no,0,$file,$line);
    my_exception_handler($e);
}

try {
  $client = new SoapClient("http://192.168.0.142:8080/services/Logon?wsdl",array(
    'exceptions' => true,
  ));
}
catch ( SoapFault $e )
{
    echo 'sorry... our service is down';
}

I have some simple SOAP client to get data from WSDL and display it.

<?php 
    //Data, connection, auth
    $dataFromTheForm = $_POST['fieldName']; // request data from the form
    $soapUrl = "https://connecting.website.com/soap.asmx?op=DoSomething"; // asmx URL of WSDL
    $soapUser = "username";  //  username
    $soapPassword = "password; // password

    // xml post structure

    $xml_post_string = '<?xml version="1.0" encoding="utf-8"?>
                        <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
                          <soap:Body>
                            <GetItemPrice xmlns="http://connecting.website.com/WSDL_Service"> // xmlns value to be set to your's WSDL URL
                              <PRICE>'.$dataFromTheForm.'</PRICE> // data from the form, e.g. some ID number
                            </GetItemPrice >
                          </soap:Body>
                        </soap:Envelope>';

        $headers = array(
                    "Content-type: text/xml;charset="utf-8"",
                    "Accept: text/xml",
                    "Cache-Control: no-cache",
                    "Pragma: no-cache",
                    "SOAPAction: http://connecting.website.com/WSDL_Service/GetPrice", // your op URL
                    "Content-length: ".strlen($xml_post_string),
                );

        $url = $soapUrl;

        // PHP cURL  for https connection with auth
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_USERPWD, $soapUser.":".$soapPassword); // username and password - declared at the top of the doc
        curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $soapUrl); // asmx URL of WSDL - declared at the top of the doc
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

        // converting
        $response = curl_exec($ch); 
        curl_close($ch);

        // converting
        $response1 = str_replace("<soap:Body>","",$response);
        $response2 = str_replace("</soap:Body>","",$response1);

        // convertingc to XML
        $parser = simplexml_load_string($response2);        



?>

Everything works fine — when WSDL works fine.

But, when WSDL fails( Runtime Error on the server) my site is throwing hundreds of warnings all at line 152 which is:

$parser = simplexml_load_string($response2);

How to detect that WSDL have returned invalid XML (html error msg) and display simple error msg on this base?

I have some simple SOAP client to get data from WSDL and display it.

<?php 
    //Data, connection, auth
    $dataFromTheForm = $_POST['fieldName']; // request data from the form
    $soapUrl = "https://connecting.website.com/soap.asmx?op=DoSomething"; // asmx URL of WSDL
    $soapUser = "username";  //  username
    $soapPassword = "password; // password

    // xml post structure

    $xml_post_string = '<?xml version="1.0" encoding="utf-8"?>
                        <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
                          <soap:Body>
                            <GetItemPrice xmlns="http://connecting.website.com/WSDL_Service"> // xmlns value to be set to your's WSDL URL
                              <PRICE>'.$dataFromTheForm.'</PRICE> // data from the form, e.g. some ID number
                            </GetItemPrice >
                          </soap:Body>
                        </soap:Envelope>';

        $headers = array(
                    "Content-type: text/xml;charset="utf-8"",
                    "Accept: text/xml",
                    "Cache-Control: no-cache",
                    "Pragma: no-cache",
                    "SOAPAction: http://connecting.website.com/WSDL_Service/GetPrice", // your op URL
                    "Content-length: ".strlen($xml_post_string),
                );

        $url = $soapUrl;

        // PHP cURL  for https connection with auth
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_USERPWD, $soapUser.":".$soapPassword); // username and password - declared at the top of the doc
        curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $soapUrl); // asmx URL of WSDL - declared at the top of the doc
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

        // converting
        $response = curl_exec($ch); 
        curl_close($ch);

        // converting
        $response1 = str_replace("<soap:Body>","",$response);
        $response2 = str_replace("</soap:Body>","",$response1);

        // convertingc to XML
        $parser = simplexml_load_string($response2);        



?>

Everything works fine — when WSDL works fine.

But, when WSDL fails( Runtime Error on the server) my site is throwing hundreds of warnings all at line 152 which is:

$parser = simplexml_load_string($response2);

How to detect that WSDL have returned invalid XML (html error msg) and display simple error msg on this base?

Синтаксис

• __getFunctions () // Возвращает массив функций для обслуживания (только для режима WSDL)
• __getTypes () // Возвращает массив типов для службы (только режим WSDL)
• __getLastRequest () // Возвращает XML из последнего запроса (требуется опция trace )
• __getLastRequestHeaders () // Возвращает заголовки последнего запроса (требуется опция trace )
• __getLastResponse () // Возвращает XML из последнего ответа (требуется опция trace )
• __getLastResponseHeaders () // Возвращает заголовки последнего ответа (требуется опция trace )

параметры

замечания

$soap->requestInfo(['a', 'b', 'c']);

Режим WSDL

Сначала создайте новый объект SoapClient , передав URL-адрес в файл WSDL и, при необходимости, массив параметров.

// Create a new client object using a WSDL URL
$soap = new SoapClient('https://example.com/soap.wsdl', [
    # This array and its values are optional
    'soap_version' => SOAP_1_2,
    'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
    'cache_wsdl' => WSDL_CACHE_BOTH,
    # Helps with debugging
    'trace' => TRUE,
    'exceptions' => TRUE
]);

Затем используйте объект $soap для вызова методов SOAP.

$result = $soap->requestData(['a', 'b', 'c']);

Режим без WSDL

Это похоже на режим WSDL, за исключением того, что мы передаем NULL в качестве файла WSDL и не забудьте указать параметры location и uri .

$soap = new SoapClient(NULL, [
    'location' => 'https://example.com/soap/endpoint',
    'uri' => 'namespace'
]);

Classmaps

При создании SOAP-клиента в PHP вы также можете установить ключ classmap в массиве конфигурации. Эта classmap определяет, какие типы, определенные в WSDL, должны быть сопоставлены фактическим классам, а не по умолчанию StdClass . Причина, по которой вы хотели бы сделать это, — это то, что вы можете получить автоматическое заполнение полей и вызовов методов на этих классах, вместо того, чтобы угадывать, какие поля заданы на обычном StdClass .

class MyAddress {
    public $country;
    public $city;
    public $full_name;
    public $postal_code; // or zip_code
    public $house_number;
}

class MyBook {
    public $name;
    public $author;

    // The classmap also allows us to add useful functions to the objects
    // that are returned from the SOAP operations.
    public function getShortDescription() {
        return "{$this->name}, written by {$this->author}";
    }
}

$soap_client = new SoapClient($link_to_wsdl, [
    // Other parameters
    "classmap" => [
        "Address" => MyAddress::class, // ::class simple returns class as string
        "Book" => MyBook::class,
    ]
]);

После настройки класса карты всякий раз, когда вы выполняете определенную операцию, которая возвращает Address или Book , SoapClient будет создавать экземпляр этого класса, заполнять поля данными и возвращать их из вызова операции.

// Lets assume 'getAddress(1234)' returns an Address by ID in the database
$address = $soap_client->getAddress(1234);

// $address is now of type MyAddress due to the classmap
echo $address->country;

// Lets assume the same for 'getBook(1234)'
$book = $soap_client->getBook(124);

// We can not use other functions defined on the MyBook class
echo $book->getShortDescription();

// Any type defined in the WSDL that is not defined in the classmap
// will become a regular StdClass object
$author = $soap_client->getAuthor(1234);

// No classmap for Author type, $author is regular StdClass.
// We can still access fields, but no auto-completion and no custom functions
// to define for the objects.
echo $author->name;

Иногда мы хотим посмотреть, что отправлено и получено в запросе SOAP. Следующие методы возвратят XML в запросе и ответе:

SoapClient::__getLastRequest()
SoapClient::__getLastRequestHeaders()
SoapClient::__getLastResponse()
SoapClient::__getLastResponseHeaders()

Например, предположим, что у нас есть константа ENVIRONMENT и когда значение этой константы установлено в DEVELOPMENT мы хотим getAddress всю информацию, когда вызов getAddress вызывает ошибку. Одним из решений может быть:

try {
    $address = $soap_client->getAddress(1234);
} catch (SoapFault $e) {
    if (ENVIRONMENT === 'DEVELOPMENT') {
        var_dump(
            $soap_client->__getLastRequestHeaders()
            $soap_client->__getLastRequest(),
            $soap_client->__getLastResponseHeaders(),
            $soap_client->__getLastResponse()
        );
    }
    ...
}