使用 PHP 解析 RDDL 文檔：資源目錄描述語言實戰

什麼是 RDDL？

RDDL（Resource Directory Description Language）是一種基於 XML 的語言，用於描述命名空間 URI 下可用的資源（如 Schema、樣式表、文檔、代碼庫）。它讓機器能自動發現與某個 XML 命名空間相關的所有資源。

RDDL 文檔結構示例

<rddl:resource xmlns:rddl="https://www.rddl.org/"
    xlink:href="https://example.com/schema.xsd"
    xlink:role="https://www.w3.org/2001/XMLSchema"
    xlink:title="Example Schema" />

PHP 解析策略

由於 RDDL 文檔通常較小，推薦使用 SimpleXML + XPath 快速提取資源信息。

<?php
function parseRDDL($url) {
    $xml = simplexml_load_file($url);
    $xml->registerXPathNamespace('rddl', 'https://www.rddl.org/');
    $xml->registerXPathNamespace('xlink', 'https://www.w3.org/1999/xlink');

    $resources = [];
    foreach ($xml->xpath('//rddl:resource') as $res) {
        $href = (string)$res['href'];
        $role = (string)$res['role'];
        $title = (string)$res['title'];
        $resources[] = compact('href', 'role', 'title');
    }
    return $resources;
}

// 使用示例
$resources = parseRDDL('https://example.com/ns/myns.rddl');
foreach ($resources as $r) {
    echo "[$r[role]] $r[title] -> $r[href]\n";
}
?>

常見資源角色（xlink:role）

應用場景

• 自動化 Schema 驗證：XML 編輯器/驗證器讀取 RDDL 獲取對應 XSD。
• 文檔生成工具：根據命名空間自動下載文檔、示例代碼。
• 微服務契約發現：服務註冊中心以 RDDL 發布 API Schema、客戶端 SDK 鏈接。

注意事項

• RDDL 文檔可能包含 HTML 內容，解析時需容錯（libxml_use_internal_errors(true)）。
• 網絡請求需設置超時與重試，避免阻塞主進程。
• 緩存解析結果（以命名空間 URI 為鍵），減少遠程請求。

掌握 RDDL 解析，能讓你的 PHP 應用在 XML 生態中實現更智能的資源自動發現與集成。