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

이 기사의 예에서는 PHP가 SOAP 확장을 사용하여 WebService를 구현하는 방법을 설명합니다. 참고하실 수 있도록 모든 사람과 공유하세요. 자세한 내용은 다음과 같습니다.

최근 PHP 프로젝트에서 외부 인터페이스를 연결하는 작업에는 WebService가 포함됩니다. 검색 엔진에는 관련 기사가 많지 않습니다. 대부분 소위 강력한 오픈 소스 소프트웨어인 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는 원격 프로시저 호출(Remote Procedure Call)을 나타냅니다. 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) PHP 자체 SOAP 확장
3), NuSOAP(순수 PHP).

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

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

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

4. 예시

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

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

< &#63; 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('math.wsdl', array('soap_version'=>SOAP_1_2));
$server->setClass("math");
$server->handle(); 
&#63;>

참고:

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

< &#63; php
// $client = new SoapClient('http://localhost/php/soap/math.wsdl');
$client = new SoapClient("http://localhost/php/soap/soap_server.php&#63;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()}";
}
&#63;>

本质上，http://localhost/php/soap/soap_server.php?WSDL就是要访问到注释行所指的wsdl描述文件，所以这个WSDL文件必须事先生成。而对于其他语言如Java则可以动态生成。对于PHP自带的SOAP扩展要求这个WSDL文件必须事先生成好。

可以用ZendStudio生成静态的WSDL文件，此时用到math类的phpdoc作为生成WSDL的元数据。用ZendStudio生成wsdl文件时，必须正确说明Web服务目标地址，片断如下：

...
  <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相关内容感兴趣的读者可查看本站专题：《PHP运算与运算符用法总结》、《PHP网络编程技巧总结》、《PHP基本语法入门教程》、《php操作office文档技巧总结(包括word,excel,access,ppt)》、《php日期与时间用法总结》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》

希望本文所述对大家PHP程序设计有所帮助。