Web service是一个平台独立的,低耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML(标准通用标记语言下的一个子集)标准来描述、发布、发现、协调和配置这些应用程序,用于开发分布式的互操作的应用程序
Web Services
(1)基础XML + HTTP
(2)包括客户端和服务端
(3)主要元素:SOAP (简易对象访问协议),UDDI (通用描述、发现及整合),WSDL (Web services 描述语言)
需要建一个.wsdl文件,php实现方式
(1)直接用zend studio工具生成
(2)根据SoapDiscovery.class.php自动生成wsdl文件
1.php.ini文件,支持soap
extension=php_soap.dll
2.创建webservice目录
3.下载SoapDiscovery.class.php文件,放到webservice中
4.创建api.php(服务端类文件)
class api { public function Hello() { return 'hello good'; } public function test($aa) { return $aa; } public function sum($a = 0, $b = 1) { return $a + $b; } public function power($a = 0) { return pow($a,2); } }
5.新建creat_wsdl.php(生成wsdl文件的执行程序)
define('WSDL_URL','api.wsdl'); //定义WSDL文件路径 ini_set('soap.wsdl_cache_enabled','0'); //关闭WSDL缓存 include_once 'api.php'; include_once 'SoapDiscovery.class.php'; $wsdl = new SoapDiscovery('api', 'service'); //第一参数为类名,也是生成wsdl的文件名api.wsdl,第二个参数是服务的名字可以随便写 $str = $wsdl->getWSDL(); file_put_contents(WSDL_URL,$str);
运行文件http://127.0.0.1/webservice/creat_wsdl.php
在webservice下生成文件api.wsdl
说明:
任何一个webservice都需要和一个实现类绑定的
也就是调用的wsdl文件真正作用的就是实现类中的方法
6.测试
(1)修改api.php
class api { public function Hello() { return 'hello good'; } public function test($aa) { return $aa; } public function sum($a = 0, $b = 1) { return $a + $b; } public function power($a = 0) { return pow($a,2); } } $server = new SoapServer('api.wsdl', array('soap_version' => SOAP_1_2)); ##此处的api.wsdl文件是上面生成的 $server->setClass("api"); //注册Service类的所有方法 $server->handle();
添加的代码的作用是:
注册api类文件中的所有方法
(2)新建测试文件test.php(客户端)
$x = new SoapClient("http://localhost/webservice/api.php?wsdl"); try { echo date("Y-m-d H:i:s", time()); echo "<br>"; echo $x->test('ok'); echo "<br>"; echo $x->hello(); echo "<br>"; echo $x->sum(1, 2); echo "<br>"; echo $x->power(5); echo "<br>"; echo $x->powe(3); } catch (SoapFault $f) { echo "Error Message: {$f->getMessage()}"; }
运行http://127.0.0.1/webservice/test.php
说明:
如果删除了api.wsdl,要重新生成,先去掉
$server = new SoapServer('api.wsdl', array('soap_version' => SOAP_1_2)); ##此处的api.wsdl文件是上面生成的 $server->setClass("api"); //注册Service类的所有方法 $server->handle();
测试时,再加上
SoapDiscovery.class.php代码
<?php /** * Copyright (c) 2005, Braulio Jos?Solano Rojas * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of * conditions and the following disclaimer in the documentation and/or other materials * provided with the distribution. * Neither the name of the Solsoft de Costa Rica S.A. nor the names of its contributors may * be used to endorse or promote products derived from this software without specific * prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * * @version $Id$ * @copyright 2005 */ /** * SoapDiscovery Class that provides Web Service Definition Language (WSDL). * * @package SoapDiscovery * @author Braulio Jos?Solano Rojas * @copyright Copyright (c) 2005 Braulio Jos?Solano Rojas * @version $Id$ * @access public **/ class SoapDiscovery { private $class_name = ''; private $service_name = ''; /** * SoapDiscovery::__construct() SoapDiscovery class Constructor. * * @param string $class_name * @param string $service_name **/ public function __construct($class_name = '', $service_name = '') { $this->class_name = $class_name; $this->service_name = $service_name; } /** * SoapDiscovery::getWSDL() Returns the WSDL of a class if the class is instantiable. * * @return string **/ public function getWSDL() { if (empty($this->service_name)) { throw new Exception('No service name.'); } $headerWSDL = "<?xml version=/"1.0/" ?>/n"; $headerWSDL.= "<definitions name=/"$this->service_name/" targetNamespace=/"urn:$this->service_name/" xmlns:wsdl=/"http://schemas.xmlsoap.org/wsdl//" xmlns:soap=/"http://schemas.xmlsoap.org/wsdl/soap//" xmlns:tns=/"urn:$this->service_name/" xmlns:xsd=/"http://www.w3.org/2001/XMLSchema/" xmlns:SOAP-ENC=/"http://schemas.xmlsoap.org/soap/encoding//" xmlns=/"http://schemas.xmlsoap.org/wsdl//">/n"; $headerWSDL.= "<types xmlns=/"http://schemas.xmlsoap.org/wsdl//" />/n"; if (empty($this->class_name)) { throw new Exception('No class name.'); } $class = new ReflectionClass($this->class_name); if (!$class->isInstantiable()) { throw new Exception('Class is not instantiable.'); } $methods = $class->getMethods(); $portTypeWSDL = '<portType name="'.$this->service_name.'Port">'; $bindingWSDL = '<binding name="'.$this->service_name.'Binding" type="tns:'.$this->service_name."Port/">/n<soap:binding style=/"rpc/" transport=/"http://schemas.xmlsoap.org/soap/http/" />/n"; $serviceWSDL = '<service name="'.$this->service_name."/">/n<documentation />/n<port name=/"".$this->service_name.'Port" binding="tns:'.$this->service_name."Binding/"><soap:address location=/"http://".$_SERVER['SERVER_NAME'].':'.$_SERVER['SERVER_PORT'].$_SERVER['PHP_SELF']."/" />/n</port>/n</service>/n"; $messageWSDL = ''; foreach ($methods as $method) { if ($method->isPublic() && !$method->isConstructor()) { $portTypeWSDL.= '<operation name="'.$method->getName()."/">/n".'<input message="tns:'.$method->getName()."Request/" />/n<output message=/"tns:".$method->getName()."Response/" />/n</operation>/n"; $bindingWSDL.= '<operation name="'.$method->getName()."/">/n".'<soap:operation soapAction="urn:'.$this->service_name.'#'.$this->class_name.'#'.$method->getName()."/" />/n<input><soap:body use=/"encoded/" namespace=/"urn:$this->service_name/" encodingStyle=/"http://schemas.xmlsoap.org/soap/encoding//" />/n</input>/n<output>/n<soap:body use=/"encoded/" namespace=/"urn:$this->service_name/" encodingStyle=/"http://schemas.xmlsoap.org/soap/encoding//" />/n</output>/n</operation>/n"; $messageWSDL.= '<message name="'.$method->getName()."Request/">/n"; $parameters = $method->getParameters(); foreach ($parameters as $parameter) { $messageWSDL.= '<part name="'.$parameter->getName()."/" type=/"xsd:string/" />/n"; } $messageWSDL.= "</message>/n"; $messageWSDL.= '<message name="'.$method->getName()."Response/">/n"; $messageWSDL.= '<part name="'.$method->getName()."/" type=/"xsd:string/" />/n"; $messageWSDL.= "</message>/n"; } } $portTypeWSDL.= "</portType>/n"; $bindingWSDL.= "</binding>/n"; return sprintf('%s%s%s%s%s%s', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, '</definitions>'); } /** * SoapDiscovery::getDiscovery() Returns discovery of WSDL. * * @return string **/ public function getDiscovery() { return "<?xml version=/"1.0/" ?>/n<disco:discovery xmlns:disco=/"http://schemas.xmlsoap.org/disco//" xmlns:scl=/"http://schemas.xmlsoap.org/disco/scl//">/n<scl:contractRef ref=/"http://".$_SERVER['SERVER_NAME'].':'.$_SERVER['SERVER_PORT'].$_SERVER['PHP_SELF']."?wsdl/" />/n</disco:discovery>"; } } ?>
原创文章,作者:ItWorker,如若转载,请注明出处:https://blog.ytso.com/20379.html