PHP에서 SOAP 확장을 사용하여 WebService를 구현하는 방법

이 기사의 예에서는 PHP가 SOAP 확장을 사용하여 WebService를 구현하는 방법을 설명합니다. 참고로 자세한 내용은 다음과 같습니다.

최근 PHP 프로젝트에서 외부 인터페이스 연결에 대해서는 검색 엔진에 관련 기사가 많지 않습니다. 매우 강력하다고 알려진 오픈 소스 소프트웨어인 NuSOAP(다운로드 주소: http://sourceforge.net/projects/nusoap/), 즉 일부 클래스에 대한 것입니다. 글에서 설명하는 환경은 PHP 4.3입니다. 요즘에는 PHP 5.2나 PHP 5.3이 많이 사용됩니다. 먼저 시도해 보았는데 잘못 실행되었습니다. NuSOAP에서 제공하는 Soapclient 클래스가 PHP 5의 새로운 내장 SOAP 확장 SoapClient 클래스와 충돌하는 것으로 나타났습니다.

NuSOAP는 모든 PHP 환경에서 사용된다고 주장하지만 서버 보안 설정의 영향을 받지 않습니다. 다만, 클래스 파일을 많이 참조해야 하기 때문에, 실용적이라면 PHP 5에 추가된 내장 SOAP 확장을 사용하는 것이 더 낫다고 생각합니다. 먼저 SOAP에 대해 알아보세요.

1. SOAP와 XML-PRC의 비교

웹 서비스 개발 초기에 XML 형식 메시지의 첫 번째 주요 용도는 다음과 같습니다. XML-RPC 프로토콜. 여기서 RPC는 원격 프로시저 호출을 나타냅니다. XML-RPC(XML 원격 프로시저 호출)에서 클라이언트는 이름, 서비스를 실행하는 프로그램 및 입력 매개 변수를 포함해야 하는 특정 메시지를 보냅니다.

XML-RPC는 제한된 다양한 데이터 유형과 일부 간단한 데이터 구조만 사용할 수 있습니다. 사람들은 이 프로토콜이 충분히 강력하지 않다고 생각하여 SOAP가 등장했습니다. 원래 정의는 Simple Object Access Protocol이었습니다. 그 후 점차적으로 SOAP이 단순하지 않고, 객체지향 언어를 사용할 필요가 없다는 것을 모두가 깨닫게 되었고, 그래서 지금은 SOAP라는 이름만 사용하고 있습니다.

XML-RPC에는 단순한 데이터 유형 세트만 있습니다. 대신 SOAP는 XML 스키마의 지속적인 발전을 활용하여 데이터 유형을 정의합니다. 동시에 SOAP는 XML-RPC에서 필요하지 않은 XML 네임스페이스를 활용할 수도 있습니다. 이를 통해 시스템 간의 복잡성과 비호환성을 추가하는 대신 SOAP 메시지의 시작이 모든 유형의 XML 네임스페이스 선언이 될 수 있습니다.

컴퓨터 산업이 각성하면서 사람들은 XML 기반 웹 서비스의 사업적 가능성을 발견했고, 이에 따라 기업들은 아이디어, 의견, 논쟁, 표준화 시도를 지속적으로 모색하기 시작했습니다. W3C는 실제로 SOAP를 만든 XML 프로토콜 워킹 그룹(XML Protocol Working Group)도 포함된 "웹 서비스 활동"이라는 이름으로 성과 전시회를 조직하려고 시도한 적이 있습니다. 어떤 방식으로든 SOAP에 관련되거나 종속된 웹 서비스와 관련된 표준화 노력의 수는 놀랄 만큼 두 배로 늘어났습니다.

원래 SOAP는 XML-RPC의 확장으로 개발되었습니다. 주요 강조점은 WSDL 파일에서 얻은 메서드 및 변수 이름을 통해 원격 프로시저 호출을 수행하는 것입니다. 이제 지속적인 발전을 통해 사람들은 기본적으로 SOAP 봉투를 사용하여 XML 형식의 파일을 보내는 "파일" 방법보다 SOAP를 사용하는 더 많은 방법을 발견했습니다. 어쨌든 SOAP를 마스터하려면 WSDL의 역할을 이해하는 것이 기본입니다.

2. SOAP 패킷 구조 분석

SOAP 헤더와 SOAP 본문을 포함하는 SOAP 메시지를 SOAP 봉투라고 합니다. 그 중 SOAP Header는 보안(인증서를 사용하여 Web Service에 접속) 등 Web Service의 기능을 확장하기 위해 다양한 메시지를 쉽게 삽입할 수 있으며, SOAP Body는 Marshall 이후의 정보인 특정 메시지 텍스트입니다.

SOAP 호출 시 HTTP Post 메시지를 URL(예: http://api.google.com/search/beta2)로 보냅니다. (SOAP 사양에 따라 HTTP Get 메시지도 지원 가능) ), 호출 메소드의 이름은 HTTP 요청 헤더 SOAP-Action에 제공되며 다음 단계는 SOAP Envelope입니다. 서버는 요청을 수신하고, 계산을 수행하고, 반환된 결과를 XML로 마샬링한 후 HTTP를 사용하여 클라이언트에 반환합니다.

3. 간단한 SOAP 예

SOAP 개발에는 일반적으로 세 가지 방법이 있습니다.

1) PEAR 자체 SOAP 확장
2) 자체 SOAP 확장
3), NuSOAP(순수 PHP).

PHP 5에는 PHP의 일부로 제공되는 SOAP 확장 기능이 내장되어 있어 별도의 패키지를 다운로드, 설치, 관리할 필요가 없습니다. 이는 PHP 대신 C로 작성된 최초의 SOAP 구현이므로 작성자는 훨씬 더 빠르다고 주장합니다. 관련 문서는 PHP 매뉴얼(php_soap.dll)의 함수 참조 섹션에 포함되어 있습니다.

.NET WEB 서비스에 액세스하는 클라이언트의 예:

< ? php
$objSoapClient = new SoapClient("http://www.webservicemart.com/uszip.asmx?WSDL");
$param = array("ZipCode"=>&#39;12209&#39;);
$out = $objSoapClient->ValidateZip($param);
$data = $out->ValidateZipResult;
echo $data;
?>

4. 예

1) PHP를 사용하여 SOAP 서비스 만들기

soap_server.php 생성(가상 경로: http://localhost/php/soap/soap_server.php)

< ? php
/**
* A simple math utility class
*/
class math{
  /**
  * Add two integers together
  *
  * @param integer $a The first integer of the addition
  * @param integer $b The second integer of the addition
  * @return integer The sum of the provided integers
  */
  public function add($a, $b){
    return $a + $b;
  }
  /**
  * Subtract two integers from each other
  *
  * @param integer $a The first integer of the subtraction
  * @param integer $b The second integer of the subtraction
  * @return integer The difference of the provided integers
  */
  public function sub($a, $b){
    return $a - $b;
  }
  /**
  * Div two integers from each other
  *
  * @param integer $a The first integer of the subtraction
  * @param integer $b The second integer of the subtraction
  * @return double The difference of the provided integers
  */
  public function div($a, $b){
    if($b == 0){
      throw new SoapFault(-1, "Cannot divide by zero!");
    }
    return $a / $b;
  }
}
$server = new SoapServer(&#39;math.wsdl&#39;, array(&#39;soap_version&#39;=>SOAP_1_2));
$server->setClass("math");
$server->handle();
?>

참고:

a) 수학 수업은 곧 공개될 웹 서비스입니다.
b) $server->addClass가 아니라 $server->setClass입니다.
2) 새로 생성된 SOAP 서비스에 접근하기 위해 PHP 클라이언트를 사용

< ? php
// $client = new SoapClient(&#39;http://localhost/php/soap/math.wsdl&#39;);
$client = new SoapClient("http://localhost/php/soap/soap_server.php?WSDL");
try{
  $result = $client->div(8, 2); // will cause a Soap Fault if divide by zero
  print "The answer is: $result";
}catch(SoapFault $e){
  print "Sorry an error was caught executing your request: {$e->getMessage()}";
}
?>

기본적으로 http://localhost/php/soap/soap_server.php?WSDL에 접근하는 것은 댓글입니다. 줄은 wsdl 설명 파일을 참조하므로 이 WSDL 파일을 미리 생성해야 합니다. Java 등 다른 언어의 경우 동적으로 생성할 수 있습니다. PHP와 함께 제공되는 SOAP 확장의 경우 이 WSDL 파일을 미리 생성해야 합니다.

ZendStudio를 사용하여 정적 WSDL 파일을 생성할 수 있습니다. 이때 수학 클래스의 phpdoc을 메타데이터로 사용하여 WSDL을 생성합니다. ZendStudio를 사용하여 wsdl 파일을 생성할 때 웹 서비스 대상 주소를 올바르게 명시해야 합니다.

...
  <service name="mathService">
    <port binding="typens:mathBinding" name="mathPort">
      <soap:address location="http://localhost/php/soap/soap_server.php"></soap:address>
    </port>
  </service>
...

   

注：调用PHP Webserver的方法必须传入命名参数。

更多PHP使用SOAP扩展实现WebService的方法相关文章请关注PHP中文网！