PHP webservice初探

背景：在最近的开发中，为了解决公司内部系统与外部系统的对接，开始接触到了webservice接口，外部公司提供接口供我们调用，已达到数据同步的目的，因此有必要普及一下web service的知识了！

什么是web service：web service是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记御园下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。

webservice三要素：SOAP、WSDL(WebServicesDescriptionLanguage)、UDDI(UniversalDescriptionDiscovery andIntegration)之一， soap用来描述传递信息的格式， WSDL 用来描述如何访问具体的接口， uddi用来管理，分发，查询webService 。具体实现可以搜索 Web Services简单实例 ; SOAP 可以和现存的许多因特网协议和格式结合使用，包括超文本传输协议（HTTP），简单邮件传输协议（SMTP），多用途网际邮件扩充协议（MIME）。它还支持从消息系统到远程过程调用（RPC）等大量的应用程序。SOAP使用基于XML的数据结构和超文本传输协议(HTTP)的组合定义了一个标准的方法来使用Internet上各种不同操作环境中的分布式对象。

什么是SOAP：SOAP 是基于 XML 的简易协议，可使应用程序在 HTTP 之上进行信息交换。

SOAP 指简易对象访问协议
SOAP 是一种通信协议
SOAP 用于应用程序之间的通信
SOAP 是一种用于发送消息的格式
SOAP 被设计用来通过因特网进行通信
SOAP 独立于平台
SOAP 独立于语言
SOAP 基于 XML
SOAP 很简单并可扩展
SOAP 允许您绕过防火墙
SOAP 将被作为 W3C 标准来发展

HTTP与SOAP：

通俗易懂的一种说法（HTTP就是邮局的协议，他们规定了你的信封要怎么写，要贴多少邮票等，SOAP就是你们之间交流的协议，负责把你所需要表达的意思写在信纸上，同时也负责让对方能够看得懂你的信。）；
事实上HTTP是SOAP消息的最常见的传输工具。soap将信息进行XML的序列化后，再用http协议的方式再打包进行传送，传送的方式还是tcp或者udp。做个比喻就好理解了。tcp 和 udp 都是公路，暂且把tcp认为是一般公路，udp高速公路，soap和http就都是汽车，那么soap和http都可以在tcp和udp上跑。说soap可以通过http来传送，实际就是说soap是小轿车，http是装轿车的卡车，把soap的信息装到http里面，然后再运输，当然走的道路还是tcp或udp。说soap可以通过http协议来传输，这句话不太准确，比较准确第说法是：soap信息可以通过http协议包装后通过tcp或udp传输。

什么是WSDL：WSDL（网络服务描述语言，Web Services Description Language）是一门基于 XML 的语言，用于描述 Web Services 以及如何对它们进行访问。

WSDL 指网络服务描述语言
WSDL 使用 XML 编写
WSDL 是一种 XML 文档
WSDL 用于描述网络服务
WSDL 也可用于定位网络服务
WSDL 还不是 W3C 标准

什么是UDDI：UDDI 是一种目录服务，企业可以使用它对 Web services 进行注册和搜索。

UDDI 指的是通用描述、发现与集成服务
UDDI 是一种用于存储有关 web services 的信息的目录。
UDDI 是一种由 WSDL 描述的 web services 界面的目录。
UDDI 经由 SOAP 进行通信
UDDI 被构建入了微软的 .NET 平台

UDDI基于什么：

UDDI 使用 W3C 和 IETF* 的因特网标准，比如 XML、HTTP 和 DNS 协议。
UDDI 使用 WSDL 来描述到达 web services 的界面
此外，通过采用 SOAP，还可以实现跨平台的编程特性，大家知道，SOAP 是 XML 的协议通信规范，可在 W3C 的网站找到相关的信息。

PHP创建webservice：

前提：环境要确保PHP支持SOAP；

创建一个.wsdl文件（方式：1、使用zend studio工具直接生成；2、使用SoapDiscovery.class.php自动生成wsdl文件）

定义服务类：Service.php，该服务端就是实现对外提供的接口，比如写一个类（Person.class.php）；代码如下：

<?php

/**
 * Created by PhpStorm.
 * User: 黎志明
 * Date: 2018/6/19
 * Time: 11:40
 */
class Person
{
    public function say()
    {
        return "我在说话。";
    }
    public function run()
    {
        return "我在跑步";
    }
}

创建service.php文件，生成.wsdl文件，代码如下：

<?php
/**
 * Created by PhpStorm.
 * User: 黎志明
 * Date: 2018/6/19
 * Time: 11:41
 */
include("Person.class.php");
include("SoapDiscovery.class.php");
//第一个参数是类名（生成的wsdl文件就是以它来命名的），即person类，第二个参数是服务的名字（这个可以随便写）。
$disco = new SoapDiscovery('Person', 'Person');
$disco->getWSDL();

浏览器直接访问Service.php，生成Person.wsdl文件

<?xml version="1.0" ?>
<definitions name="Person" targetNamespace="urn:Person" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
             xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="urn:Person"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
             xmlns="http://schemas.xmlsoap.org/wsdl/">
    <types xmlns="http://schemas.xmlsoap.org/wsdl/"/>
    <portType name="PersonPort">
        <operation name="say">
            <input message="tns:sayRequest"/>
            <output message="tns:sayResponse"/>
        </operation>
        <operation name="run">
            <input message="tns:runRequest"/>
            <output message="tns:runResponse"/>
        </operation>
    </portType>
    <binding name="PersonBinding" type="tns:PersonPort">
        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="say">
            <soap:operation soapAction="urn:Person#Person#say"/>
            <input>
                <soap:body use="encoded" namespace="urn:Person"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </input>
            <output>
                <soap:body use="encoded" namespace="urn:Person"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </output>
        </operation>
        <operation name="run">
            <soap:operation soapAction="urn:Person#Person#run"/>
            <input>
                <soap:body use="encoded" namespace="urn:Person"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </input>
            <output>
                <soap:body use="encoded" namespace="urn:Person"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </output>
        </operation>
    </binding>
    <service name="Person">
        <documentation/>
        <port name="PersonPort" binding="tns:PersonBinding">
            <soap:address location="http://localhost:80/wsdl/Service.php"/>
        </port>
    </service>
    <message name="sayRequest">
    </message>
    <message name="sayResponse">
        <part name="say" type="xsd:string"/>
    </message>
    <message name="runRequest">
    </message>
    <message name="runResponse">
        <part name="run" type="xsd:string"/>
    </message>
</definitions>

将Service.php文件的内容清空，把一下代码复制进去：

<?php
/**
 * Created by PhpStorm.
 * User: 黎志明
 * Date: 2018/6/19
 * Time: 11:41
 */

include("Person.class.php");
$objSoapServer = new SoapServer("Person.wsdl");//person.wsdl是刚创建的wsdl文件
//$objSoapServer = new SoapServer("server.php?wsdl");//这样也行
$objSoapServer->setClass("Person");//注册person类的所有方法
$objSoapServer->handle();//处理请求

创建webservice客户端程序，测试webservice是否邮箱，文件名为：client.php，代码如下：

<?php
/**
 * Created by PhpStorm.
 * User: 黎志明
 * Date: 2018/6/19
 * Time: 11:59
 */
$client = new SoapClient("Person.wsdl");
//$client = new SoapClient("server.php?wsdl");//这样也行 
echo $client->say();
echo "<br />";
echo $client->run();
echo "<br />";

　　小结：.NET如果要使用的话，只要提供一个url给他就行了；获得url的方法：你可以先到Person.wsdl文件里面查找<soap:address location="http://localhost:80/wsdl/Service.php" />，这里的url（具体url是根据你的目录确定的）就是你要提供给.NET开发人员使用的；不过别高兴太早，后面要加：“?wsdl”，http://localhost:80/wsdl/Service.php?wsdl这样才是对的，不信你可以将url拷贝到浏览器的地址栏里看下就知道了，.NET开发人员获得你给他的url之后，就可以在自己的项目里面添加一个服务引用或者web引用了，然后就可以根据提示完成相关操作，对于使用.NET的开发人员来说很简单的。

posted @ 2018-06-19 14:24 Timothy_lai 阅读(691) 评论(0) 编辑收藏举报

刷新页面返回顶部

Timothy_lai

PHP webservice初探

公告