PHP SOAP 服務端接口封裝：按業務需求決定是否封裝，參考最佳實踐

是否需要封裝

視業務複雜度而定：

• 簡單 CRUD、單一 WSDL、無跨服務調用 → 直接用 SoapServer 暴露類方法，無需額外封裝層。
• 多版本 WSDL、需統一異常處理/日志/驗證/權限/熔斷/監控 → 必須封裝統一入口層。

封裝層職責

1. WSDL 管理：動態生成/緩存/版本路由。
2. 請求預處理：解析 SOAP Header (Token/簽名)、驗證簽名/時間戳/重放防護。
3. 業務分發：路由至具體 Service 類，捕獲異常轉為標準 SOAP Fault (soap:Fault)。
4. 響應後處理：記錄訪問日志、性能指標、敏感字段脫敏。

代碼骨架

class SoapEntryPoint {
    public function __call($method, $args) {
        try {
            // 1. 驗證 SOAP Header
            $this->validateHeader();
            // 2. 實例化業務服務
            $service = new BusinessService();
            // 3. 調用並返回
            return $service->$method(...$args);
        } catch (ValidationException $e) {
            throw new SoapFault('Client', $e->getMessage());
        } catch (Exception $e) {
            error_log($e);
            throw new SoapFault('Server', 'Internal error');
        }
    }
}

$server = new SoapServer('service.wsdl', ['cache_wsdl' => WSDL_CACHE_MEMORY]);
$server->setObject(new SoapEntryPoint());
$server->handle();

參考資源

• PHP 官方文檔：SoapServer
• 博客「終於解決了 PHP 調用 SOAP 過程中的種種問題」—— 實戰踩坑總結。