2024 年 PHP 日本會議

    XMLWriter::startDocument

    xmlwriter_start_document

    (PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL xmlwriter >= 0.1.0)

    XMLWriter::startDocument -- xmlwriter_start_document — 建立文件標籤

    說明

    物件導向風格

    public XMLWriter::startDocument(?string $version = "1.0", ?string $encoding = null, ?string $standalone = null): bool

    程序式風格

    xmlwriter_start_document(
        XMLWriter $writer,
        ?string $version = "1.0",
        ?string $encoding = null,
        ?string $standalone = null
    ): bool

    開始一個文件。

    參數

    writer

    僅限程序式呼叫。正在被修改的 XMLWriter 實例。此物件是由呼叫 xmlwriter_open_uri() 或 xmlwriter_open_memory() 所返回。

    version

    文件版本號，作為 XML 宣告的一部分。

    encoding

    文件編碼，作為 XML 宣告的一部分。

    standalone

    yes 或 no。

    返回值

    成功時返回 true，失敗時返回 false。

    錯誤／例外

    傳遞包含空位元組的 encoding 將會拋出 ValueError。

    更新日誌

    版本 說明
    8.4.0 傳遞包含空位元組的 encoding 現在將會拋出 ValueError。
    8.0.0 writer 現在預期是一個 XMLWriter 實例；先前預期是一個 resource。

    另請參閱

    發現問題了嗎？

    了解如何改進此頁面 • 提交拉取請求 • 回報錯誤
    ＋新增註解

    使用者貢獻的註解 1 則註解

    3
    Sbastien
    2 年前
    XMLWriter::startDocument() 會寫入 XML 宣告。

    沒有 XMLWriter::startDocument()

    <?php

    $xml     = new XMLWriter();
    $xml->openUri('php://stdout');
    $xml->writeElement('message', 'Hello World!');
    exit;

    /*
    輸出：
    <message>Hello World!</message>
    */
    ?>

    使用 XMLWriter::startDocument()

    <?php

    $xml     = new XMLWriter();
    $xml->openUri('php://stdout');
    $xml->startDocument();
    $xml->writeElement('message', 'Hello World!');
    exit;

    /*
    輸出：
    <?xml version="1.0"?>
    <message>Hello World!</message>
    */
    ?>
    ＋新增註解
    To Top