PHP
SOAP 클라이언트

통사론

• __getFunctions () // 서비스 용 함수 배열을 반환합니다 (WSDL 모드에만 해당).
• __getTypes () // 서비스 유형 배열을 반환합니다 (WSDL 모드에만 해당).
• __getLastRequest () // 마지막 요청에서 XML을 반환합니다 ( trace 옵션 필요).
• __getLastRequestHeaders () // 마지막 요청의 헤더를 반환합니다 ( trace 옵션 필요).
• __getLastResponse () // 마지막 응답에서 XML을 반환합니다 ( trace 옵션 필요).
• __getLastResponseHeaders () // 마지막 응답의 헤더를 반환합니다 ( trace 옵션 필요).

매개 변수

비고

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

WSDL 모드

먼저 URL을 WSDL 파일에 전달하고 선택적으로 옵션 배열을 전달하여 새 SoapClient 객체를 만듭니다.

// 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 을 전달하고 location 및 uri 옵션을 설정해야한다는 점을 제외하면 WSDL 모드와 유사합니다.

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

클래스 맵

PHP에서 SOAP 클라이언트를 생성 할 때 구성 배열에 classmap 키를 설정할 수도 있습니다. 이 클래스 맵은 WSDL에 정의 된 유형을 기본 StdClass 대신 실제 클래스에 매핑 classmap 정의합니다. 그 이유는 일반 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 요청 및 응답 추적

때로는 SOAP 요청에서 보내고받은 것을 보려고합니다. 다음 메소드는 요청 및 응답에서 XML을 리턴합니다.

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

예를 들어 ENVIRONMENT 상수가 있다고 가정하고이 상수의 값이 DEVELOPMENT 로 설정된 경우 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()
        );
    }
    ...
}