PHP를 이용한 웹 서비스 개발(2)

제공 : 한빛 네트워크
저자 : Deepak Vohra
역자 : 이대엽
원문 : Developing Web Services Using PHP

[이전 기사 보기]
PHP를 이용한 웹 서비스 개발(1)

SOAP 클라이언트 만들기

soap-client.php라는 PHP 스크립트를 C:Apache2htdocs 디렉터리에 만든다. PHP 스크립트에는 SoapClient 클래스를 이용하여 SOAP 클라이언트를 만든다. SoapClient 생성자의 인자로서 WSDL 문서인 catalog.wsdl을 지정한다. WSDL 문서는 SOAP 클라이언트에서 사용할 수 있는 오퍼레이션들이 기술되어 있다.

$client = new SoapClient("catalog.wsdl");

검색할 엔트리의 catalogId를 지정한다. SOAP 웹 서비스의 getCatalogEntry 메소드를 호출한다.

$catalogId='catalog1';
$response = $client->getCatalogEntry($catalogId);

응답결과를 브라우저에 출력한다.

echo $response;

soap-client.php 스크립트가 아래에 나타나 있다.

<?php  
  $client = new SoapClient("catalog.wsdl");
  $catalogId='catalog1';
  $response = $client->getCatalogEntry($catalogId);
  echo $response;
?>

http://localhost/soap-client.php URL을 통해 soap-client.php PHP 스크립트를 호출한다. catalog1 catalogId에 대한 카탈로그 엔트리의 출력결과가 그림 1에 나타나 있다. 


그림 1. SOAP 클라이언트 호출

XML-RPC 웹 서비스 만들기

XML-RPC는 명세(specification)이자 네트워크상으로 원격 프로시저 호출을 하는 애플리케이션을 위해 설계된 구현체의 집합이다. 원격 프로시저 호출(remote procedure call)은 HTTP를 전송 매개체로, XML을 인코딩으로 이용하여 이루어진다.

XML-RPC 요청 및 응답의 구조

XML-RPC 메시지는 HTTP-POST 요청이다. 요청 본문(request body)은 XML 형식으로 되어 있다. 요청은 XML-RPC 서버로 보내지는데, XML-RPC 서버는 비즈니스 로직을 실행하여 XML 형태로 응답을 반환한다. XML-RPC 요청의 예가 아래에 나타나 있다.

POST /php/xmlrpc-server.php HTTP/1.0
User-Agent: Example Client
Host: localhost
Content-Type: text/xml
Content-length: 190

<?xml version="1.0"?>
<methodCall>
   <methodName>getCatalog</methodName>
   <params>
      <param>
         <value><string>catalog1
         </string></value>
         </param>
      </params>
   </methodCall>

헤더의 /php/xmlrpc-server.php URI는 요청이 전송될 서버 URI를 지정한다. HTTP 버전도 지정되어 있다. User-Agent와 Host도 지정할 필요가 있다. Content-Type은 text/xml이며 Content-Length는 내용의 길이를 지정한다.

요청 본문은 methodCall을 루트 엘리먼트로 포함하는 XML에 들어있다. methodCall 엘리먼트는 호출될 메소드의 이름이 문자열로 지정되어 있는 methodName이라는 이름의 하위 엘리먼트를 포함할 필요가 있다. XML-RPC 요청이 매개변수를 가질 경우, methodCall 엘리먼트는 하위 엘리먼트로 params를 포함한다. params 엘리먼트는 하나 이상의 param 엘리먼트들을 포함한다. 각각의 param 엘리먼트는 value 엘리먼트를 포함한다. param 값은 문자열(string), 불린(Boolean), 부호있는 4바이트 정수(four-byte signed integer), 부호있는 배정도수(double-precision signed), 부동 소수점 수(floating point number), 날짜/시간(date/time), 혹은 base-64 인코딩 바이너리(base-64 encoding binary)로 지정할 수 있다. param 값에 지정된 value 엘리먼트의 하위 엘리먼트는 각각의 값 타입에 따라 다르다. 타입이 지정되지 않았을 경우의 기본 타입은 문자열이다. 값 타입에 따른 하위 엘리먼트들이 표 3에 나열되어 있다.

표 3. Value엘리먼트

값 타입	엘리먼트
아스키(ASCII) 문자열	<string>
부호있는 4바이트 정수(Four-byte signed integer)	<i4> or <int>
불린(Boolean)	<boolean>
부호있는 배정도수(double-precision signed)나 부동 소수점 수(floating point number)	<double>
날짜/시간(Date/time)	<dateTime.iso8601>
Base-64 인코딩 바이너리(base-64 encoded binary)	<base64>

또한 param 값은 <struct> 타입도 될 수 있다. <struct> 엘리먼트는 <member> 엘리먼트들로 구성된다. 각각의 <member> 엘리먼트는 <name> 엘리먼트와 <value> 엘리먼트를 포함한다. struct 값의 예가 아래에 나타나 있다.

<struct>
   <member>
      <name>catalogId</name>
      <value><string>catalog1
      </string></value>
      </member>
   <member>
      <name>journal</name>
      <value><string>IBM developerWorks
      </string></value>
      </member>
   </struct>

member 엘리먼트에 들어있는value 엘리먼트는 struct를 포함하여 어떠한 param 데이터 타입도 될 수 있다. param 타입으로 <array> 타입도 가능하다. <array> 엘리먼트는 <data> 엘리먼트로 구성되는데, <data> 엘리먼트는 하나 이상의 <value> 엘리먼트들로 이루어져 있다. <array> param 값의 예가 아래에 나타나 있다.

<array>
   <data>
      <value><i4>1</i4></value>
      <value><string>IBM developerWorks
      </string></value>
      <value>XML</value>
      <value><string>Introduction to dom4j
      </string></value>
      <value><string>Deepak Vohra</string
      ></value>
      </data>
   </array>

<data> 엘리먼트안의 <value> 엘리먼트는 struct와 array를 포함하여 어떠한 데이터 타입으로도 구성할 수 있다. XML-RPC 요청에 대한 서버측 응답은 XML 형식을 띤다. 응답의 예가 아래에 나타나 있다.

HTTP/1.1 200 OK
Connection: close
Content-Length: 190
Content-Type: text/xml
Date: 
Server: Example Server

<?xml version="1.0"?>
<methodResponse>
   <params>
      <param>
         <value><string>Introduction 
         to SQLXML</string></value>
         </param>
      </params>
   </methodResponse>

오류가 발생하지 않을 경우 서버측 응답은 “200 OK”를 반환한다. Connection 헤더는 응답이 완료된 후의 연결 상태를 기술한다. 비지속적인 연결에 대한 Connection 헤더의 값은 “close”이다. Content-Type은 text/xml이다. 응답 내용은 methodResponse를 루트 엘리먼트로 가지는 XML 형식을 띤다. methodResponse 엘리먼트는 하나의 <params> 엘리먼트로 구성되는데, 하나의 <param> 엘리먼트로 구성되어 있다. <param> 엘리먼트는 하나의 <value> 엘리먼트만을 포함하고 있다.

< params> 엘리먼트 대신 methodResponse 엘리먼트는 하나의 <fault> 엘리먼트로도 구성될 수 있다. <fault> 엘리먼트는 <value> 엘리먼트를 포함하는데, <fault> 엘리먼트는 정수 타입의 faultCode와 문자열 타입의 faultString으로 두 개의 <member> 엘리먼트를 갖는 <struct> 엘리먼트를 가진다. <fault> 엘리먼트를 가지는 XML-RPC 서버 응답의 예가 아래에 나타나 있다.

HTTP/1.1 200 OK
Connection: close
Content-Length: 190
Content-Type: text/xml
Date: 
Server: Example Server

<?xml version="1.0"?>
<methodResponse>
   <fault>
      <value>
         <struct>
            <member>
               <name>faultCode</name>
               <value><int>4</int
               ></value>
               </member>
            <member>
               <name>faultString</name>
               <value><string>No such Method.
               </string></value>
               </member>
            </struct>
         </value>
      </fault>
   </methodResponse>