PHP Conference Japan 2024

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

yesno

返回值

成功时返回 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