PHP webservice初探

时间 2019-11-11

标签 php webservice 初探栏目 PHP 繁體版

原文原文链接

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

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

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 进行注册和搜索。tcp

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文件（方式：一、使用zend studio工具直接生成；二、使用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的开发人员来讲很简单的。