PHP WebService WSDL 中文導致 XML 無法顯示的解決方案：UTF-8 無 BOM 編碼統一

PHP 開發 WebService 時，WSDL 文件包含中文導致 XML 解析錯誤或瀏覽器顯示亂碼。根因通常是文件編碼不一致或輸出未聲明 charset。本文給出標準化解決流程。

問題現象

• 瀏覽器訪問 ?wsdl 顯示「XML 解析錯誤：編碼聲明錯誤」或亂碼。
• SoapClient 實例化拋出 SOAP-ERROR: Parsing WSDL。

核心解決方案：統一 UTF-8 無 BOM

1. 編輯器保存為 UTF-8 無 BOM：
   • Notepad++：編碼 → 轉為 UTF-8 (無 BOM)
   • VS Code：右下角編碼選 UTF-8（預設無 BOM）
   • PhpStorm：File → File Encoding → UTF-8
2. PHP 腳本頭部聲明：

   <?php
   header('Content-Type: text/xml; charset=utf-8');
   // 或 SOAP 服務端
   $server = new SoapServer('service.wsdl', ['encoding' => 'UTF-8']);
   

3. WSDL 文件內聲明：

   <?xml version="1.0" encoding="UTF-8"?>
   <definitions ...> ... </definitions>
   

4. 資料庫連接編碼：

   $pdo->exec("SET NAMES utf8mb4");
   

常見誤區對照

驗證清單

[ ] 所有 .php/.wsdl/.xsd 文件均為 UTF-8 無 BOM
[ ] HTTP 響應頭 Content-Type: text/xml; charset=utf-8
[ ] XML 聲明 <?xml version="1.0" encoding="UTF-8"?>
[ ] SoapServer/SoapClient 構造參數 encoding='UTF-8'
[ ] 資料庫/外部服務編碼一致
[ ] 瀏覽器直接訪問 ?wsdl 正常顯示中文
[ ] SoapClient 消費無異常

進階：動態生成 WSDL 時的編碼控制

<?php
// 動態輸出 WSDL
header('Content-Type: text/xml; charset=utf-8');
echo '' . "\n";
echo '';
// ... 確保所有動態插入字符串已是 UTF-8
echo '';

「全鏈路 UTF-8 無 BOM」是解決 PHP WebService 中文問題的黃金法則，一次配置，永久免疫編碼地雷。