PHP 8.4.2 Released!

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 note

up
1
Sbastien
2 years ago
XMLWriter::startDocument() writes the XML declaration.

Without XMLWriter::startDocument() :

<?php

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

/*
Outputs :
<message>Hello World!</message>
*/
?>

With XMLWriter::startDocument() :

<?php

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

/*
Outputs :
<?xml version="1.0"?>
<message>Hello World!</message>
*/
?>
To Top