您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP WebService 開發全攻略：從 WSDL 生成到 SOAP 客戶端調用實戰

編輯：PHP 相關知識

WebService 是異構系統集成的經典方案，基於 SOAP 協議、WSDL 描述語言，通過 HTTP 傳輸 XML 數據。PHP 內置 SoapServer 和 SoapClient 類，配合 SoapDiscovery 工具類，可快速構建標準化的 WebService 服務端與客戶端。本文通過完整實例演示從零構建一個可用的 PHP WebService。

核心概念速覽

SOAP：簡易對象訪問協議，定義 XML 消息格式
WSDL：Web 服務描述語言，描述服務接口、參數、返回類型、綁定協議
UDDI：通用描述發現整合，服務註冊發現目錄（現較少用）

服務端開發三步走

步驟 1：編寫業務邏輯類

<?php
// Service.php
class Service
{
    public function Hello(): string
    {
        return 'Hello, SOAP WebService!';
    }

    public function Add(float $a, float $b): float
    {
        return $a + $b;
    }

    public function GetUserInfo(int $uid): array
    {
        // 模擬數據庫查詢
        return [
            'id' => $uid,
            'name' => "User_{$uid}",
            'email' => "user{$uid}@example.com",
            'created_at' => date('Y-m-d H:i:s'),
        ];
    }
}

步驟 2：自動生成 WSDL 文件

使用 SoapDiscovery.class.php（需從網上下載或使用 Zend Studio 生成）：

<?php
// create_wsdl.php
require_once 'Service.php';
require_once 'SoapDiscovery.class.php';

$wsdl = new SoapDiscovery('Service', 'MySoapService'); // 類名、服務名
$wsdl->getWSDL(); // 直接輸出 WSDL XML，可重定向保存為 Service.wsdl

運行後將輸出保存為 Service.wsdl，部署時與 Service.php 放同級目錄。

步驟 3：創建 SOAP 服務端入口

<?php
// server.php
require_once 'Service.php';

$options = [
    'soap_version' => SOAP_1_2,
    'encoding' => 'UTF-8',
    'actor' => 'https://example.com/soap/server',
];
$server = new SoapServer('Service.wsdl', $options);
$server->setClass('Service');
$server->handle();

客戶端調用實戰

<?php
// client.php
ini_set('soap.wsdl_cache_enabled', 0); // 開發期關閉 WSDL 緩存
ini_set('default_socket_timeout', 10); // 設置超時

try {
    $client = new SoapClient('https://127.0.0.1/soap/server.php?wsdl', [
        'trace' => 1,              // 開啟調試追蹤
        'exceptions' => true,      // 拋出異常而非 PHP 錯誤
        'cache_wsdl' => WSDL_CACHE_NONE,
    ]);

    // 方式 1：直接調用方法（推薦）
    echo "Add(10, 20) = {$client->Add(10, 20)}\n"; // 30

    // 方式 2：使用 __soapCall（動態方法名）
    $result = $client->__soapCall('GetUserInfo', [['uid' => 1001]]);
    print_r($result);

    // 調試：查看最後請求/響應 XML
    echo "REQUEST:\n{$client->__getLastRequest()}\n";
    echo "RESPONSE:\n{$client->__getLastResponse()}\n";

} catch (SoapFault $e) {
    echo "SOAP Fault: {$e->getMessage()}\n";
    echo "Code: {$e->faultcode}\n";
}

進階配置與避坑指南

WSDL 緩存機制

PHP 默認緩存 WSDL 文件（php.ini 中 soap.wsdl_cache_ttl=86400），開發期必須關閉：

ini_set('soap.wsdl_cache_enabled', '0'); // 或 php.ini 設置

複雜類型與數組傳遞

WSDL 中定義 complexType 映射 PHP 關聯數組，客戶端直接傳遞數組即可：

$params = [
    'user' => [
        'name' => '張三',
        'age' => 25,
        'tags' => ['vip', 'developer'],
    ],
];
$client->CreateUser($params);

異常處理最佳實踐

try {
    $result = $client->SomeMethod($params);
} catch (SoapFault $e) {
    // 記錄詳細錯誤信息
    error_log("SOAP Error: {$e->faultstring} | Code: {$e->faultcode}");
    // 可選：嘗試重試或降級處理
}

HTTPS 與證書驗證

$client = new SoapClient('https://api.example.com/service?wsdl', [
    'stream_context' => stream_context_create([
        'ssl' => [
            'verify_peer' => true,
            'verify_peer_name' => true,
            'cafile' => '/path/to/ca-bundle.crt',
        ],
    ]),
]);