PHP: полный мануал с примерами, функциями и ООП

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::openMemory(): bool

Подготовить писатель для небольшой XML-строки: например тела запроса к службе доставки.

Метод возвращает bool; xmlwriter_open_memory() возвращает XMLWriter|false. Повторное открытие заменяет прежний приёмник и сбрасывает настройки отступов: сначала заберите нужный результат. Объём XML в памяти растёт; для большой выгрузки выбирайте URI/поток.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_open_memory(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('status', 'ready');
echo $w->outputMemory(), "\n";

<status>ready</status>

<?php
function statusXml($status) {
    $writer = xmlwriter_open_memory();
    if ($writer === false) {
        throw new RuntimeException('Нет буфера');
    }
    xmlwriter_write_element($writer, 'status', $status);
    return xmlwriter_output_memory($writer);
}
echo statusXml('paid'), "
";
echo statusXml('sent'), "
";

<status>paid</status>
<status>sent</status>

Соседние операции: XMLWriter::outputMemory(), XMLWriter::openUri(), XMLWriter::toMemory().

• PHP: XMLWriter::openMemory
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_open_memory(): XMLWriter|false

Подготовить писатель для небольшой XML-строки: например тела запроса к службе доставки.

Метод возвращает bool; xmlwriter_open_memory() возвращает XMLWriter|false. Повторное открытие заменяет прежний приёмник и сбрасывает настройки отступов: сначала заберите нужный результат. Объём XML в памяти растёт; для большой выгрузки выбирайте URI/поток.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::openMemory(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('status', 'ready');
echo $w->outputMemory(), "\n";

<status>ready</status>

<?php
function statusXml($status) {
    $writer = xmlwriter_open_memory();
    if ($writer === false) {
        throw new RuntimeException('Нет буфера');
    }
    xmlwriter_write_element($writer, 'status', $status);
    return xmlwriter_output_memory($writer);
}
echo statusXml('paid'), "
";
echo statusXml('sent'), "
";

<status>paid</status>
<status>sent</status>

Соседние операции: XMLWriter::outputMemory(), XMLWriter::openUri(), XMLWriter::toMemory().

• PHP: XMLWriter::openMemory
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::openUri(string $uri): bool

Записывать XML в файл или поддерживаемый URI, не накапливая весь результат в одной строке.

Метод возвращает bool, процедурная функция — XMLWriter|false. Пустая строка/нулевой байт в пути недопустимы; в PHP 8 это ValueError. Неразрешимый путь/невозможность записи дают отказ, иногда предупреждение. Открытие файла предназначено для новой записи и может обнулить существующий: не передавайте чужой путь. На Windows файл удерживается до освобождения писателя. flush не уничтожает объект.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_open_uri(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openUri(__DIR__ . '/status.xml')) {
    throw new RuntimeException('Файл недоступен');
}
$w->writeElement('status', 'ready');
if ($w->flush() < 0) {
    throw new RuntimeException('Ошибка записи');
}
unset($w);
echo file_get_contents(__DIR__ . '/status.xml'), "
";

<status>ready</status>

<?php
$w = xmlwriter_open_uri('php://output');
if ($w === false) {
    throw new RuntimeException('Вывод недоступен');
}
xmlwriter_write_element($w, 'result', 'ok');
$written = xmlwriter_flush($w);
if ($written < 0) {
    throw new RuntimeException('Ошибка вывода');
}
unset($w);
echo "
";

<result>ok</result>

Соседние операции: XMLWriter::toUri(), XMLWriter::toStream(), XMLWriter::flush(), XMLWriter::openMemory().

• PHP: XMLWriter::openUri
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_open_uri(string $uri): XMLWriter|false

Записывать XML в файл или поддерживаемый URI, не накапливая весь результат в одной строке.

Метод возвращает bool, процедурная функция — XMLWriter|false. Пустая строка/нулевой байт в пути недопустимы; в PHP 8 это ValueError. Неразрешимый путь/невозможность записи дают отказ, иногда предупреждение. Открытие файла предназначено для новой записи и может обнулить существующий: не передавайте чужой путь. На Windows файл удерживается до освобождения писателя. flush не уничтожает объект.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::openUri(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openUri(__DIR__ . '/status.xml')) {
    throw new RuntimeException('Файл недоступен');
}
$w->writeElement('status', 'ready');
if ($w->flush() < 0) {
    throw new RuntimeException('Ошибка записи');
}
unset($w);
echo file_get_contents(__DIR__ . '/status.xml'), "
";

<status>ready</status>

<?php
$w = xmlwriter_open_uri('php://output');
if ($w === false) {
    throw new RuntimeException('Вывод недоступен');
}
xmlwriter_write_element($w, 'result', 'ok');
$written = xmlwriter_flush($w);
if ($written < 0) {
    throw new RuntimeException('Ошибка вывода');
}
unset($w);
echo "
";

<result>ok</result>

Соседние операции: XMLWriter::toUri(), XMLWriter::toStream(), XMLWriter::flush(), XMLWriter::openMemory().

• PHP: XMLWriter::openUri
• PHP 8.5.11: реализация

PHP 8.4+ · xmlwriter / libxml

XMLWriter::toMemory(): static

Создать сразу готовый писатель в памяти через статическую фабрику.

Возвращает объект вызываемого класса (static), не bool. При невозможности создать внутренний writer возникает Error. Вызов у подкласса создаёт этот подкласс; его конструктор не должен требовать обязательных аргументов. Процедурного xmlwriter_to_memory нет.

static после двоеточия означает объект того класса, у которого вызвана фабрика. В этих примерах это XMLWriter. Фабрика создаёт и подготавливает объект; при отказе не следует ожидать обычный false.

<?php
$w = XMLWriter::toMemory();
$w->writeElement('sku', 'B-12');
echo $w->outputMemory(), "
";

<sku>B-12</sku>

<?php
$order = XMLWriter::toMemory();
$stock = XMLWriter::toMemory();
$order->writeElement('order', '42');
$stock->writeElement('stock', '7');
echo $stock->outputMemory(), "
";
echo $order->outputMemory(), "
";

<stock>7</stock>
<order>42</order>

Соседние операции: XMLWriter::openMemory(), XMLWriter::toStream(), XMLWriter::toUri().

• PHP: XMLWriter::toMemory
• PHP 8.5.11: реализация

PHP 8.4+ · xmlwriter / libxml

XMLWriter::toUri(string $uri): static

Создать объект, который сразу пишет в выбранный файл/URI.

Возвращает static. Пустой/неразрешимый путь — ValueError; невозможность создать writer — Error, а не false (возможна дополнительная диагностика нижнего уровня). На Windows освободите объект перед заменой/перемещением файла. Фабрика не создаёт отсутствующие родительские каталоги. Процедурного аналога с именем to_uri нет.

static после двоеточия означает объект того класса, у которого вызвана фабрика. В этих примерах это XMLWriter. Фабрика создаёт и подготавливает объект; при отказе не следует ожидать обычный false.

<?php
$path = __DIR__ . '/shipment.xml';
$w = XMLWriter::toUri($path);
$w->writeElement('shipment', 'ready');
if ($w->flush() < 0) {
    throw new RuntimeException('Ошибка записи');
}
unset($w);
echo file_get_contents($path), "
";

<shipment>ready</shipment>

<?php
try {
    XMLWriter::toUri('');
} catch (ValueError $error) {
    echo "Нужен путь к файлу
";
}

Нужен путь к файлу

Соседние операции: XMLWriter::openUri(), XMLWriter::toMemory(), XMLWriter::toStream().

• PHP: XMLWriter::toUri
• PHP 8.5.11: реализация

PHP 8.4+ · xmlwriter / libxml

XMLWriter::toStream(resource $stream): static

Подключить XMLWriter к уже открытому записываемому PHP-потоку.

Возвращает static. Нересурс/ресурс другого вида вызывает TypeError. Создание внутренних структур может вызвать Error; непригодность потока к записи обнаруживается также при записи/flush. Позиция и владение ресурсом остаются важными: сначала flush, затем освободить writer, затем fclose. Объект удерживает ссылку на ресурс, но явное раннее fclose всё равно ломает дальнейший вывод. Нестроковый режим flush возвращает число, outputMemory к этому приёмнику не подходит.

static после двоеточия означает объект того класса, у которого вызвана фабрика. В этих примерах это XMLWriter. Фабрика создаёт и подготавливает объект; при отказе не следует ожидать обычный false.

<?php
$stream = fopen('php://temp', 'w+b');
if ($stream === false) {
    throw new RuntimeException('Нет потока');
}
$w = XMLWriter::toStream($stream);
$w->writeElement('total', '499');
if ($w->flush() < 0) {
    throw new RuntimeException('Ошибка записи');
}
unset($w);
rewind($stream);
echo stream_get_contents($stream), "
";
fclose($stream);

<total>499</total>

<?php
$stream = fopen('php://temp', 'w+b');
if ($stream === false) {
    throw new RuntimeException('Нет потока');
}
fwrite($stream, '<batch>');
$w = XMLWriter::toStream($stream);
$w->writeElement('item', 'A');
$w->flush();
unset($w);
fwrite($stream, '</batch>');
rewind($stream);
echo stream_get_contents($stream), "
";
fclose($stream);

<batch><item>A</item></batch>

Соседние операции: XMLWriter::toUri(), XMLWriter::flush(), XMLWriter::outputMemory().

• PHP: XMLWriter::toStream
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::outputMemory(bool $flush = true): string

Получить накопленный XML как строку из режима памяти.

Всегда string. Вызов проталкивает внутренний буфер writer в память, но не закрывает структуру документа. Для URI/потока не читает файл обратно: в PHP 8.5.11 возвращает пустую строку. Не путайте очистку буфера с openMemory: состояние незакрытых элементов сохраняется.

string после двоеточия означает строку. Пустая строка — допустимый результат для пустого буфера, а не автоматический признак ошибки. Получение строки и её вывод через echo — разные действия.

Другая форма вызова с тем же смыслом: xmlwriter_output_memory(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('sku', 'A');
echo $w->outputMemory(false), "\n";
echo $w->outputMemory(), "\n";
var_dump($w->outputMemory());

<sku>A</sku>
<sku>A</sku>
string(0) ""

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'items');
xmlwriter_write_element($w, 'item', 'A');
$first = xmlwriter_output_memory($w);
xmlwriter_write_element($w, 'item', 'B');
xmlwriter_end_element($w);
$second = xmlwriter_output_memory($w);
echo $first . $second, "
";

<items><item>A</item><item>B</item></items>

Соседние операции: XMLWriter::flush(), XMLWriter::openMemory().

• PHP: XMLWriter::outputMemory
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_output_memory(XMLWriter $writer, bool $flush = true): string

Получить накопленный XML как строку из режима памяти.

Всегда string. Вызов проталкивает внутренний буфер writer в память, но не закрывает структуру документа. Для URI/потока не читает файл обратно: в PHP 8.5.11 возвращает пустую строку. Не путайте очистку буфера с openMemory: состояние незакрытых элементов сохраняется.

string после двоеточия означает строку. Пустая строка — допустимый результат для пустого буфера, а не автоматический признак ошибки. Получение строки и её вывод через echo — разные действия.

Другая форма вызова с тем же смыслом: XMLWriter::outputMemory(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('sku', 'A');
echo $w->outputMemory(false), "\n";
echo $w->outputMemory(), "\n";
var_dump($w->outputMemory());

<sku>A</sku>
<sku>A</sku>
string(0) ""

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'items');
xmlwriter_write_element($w, 'item', 'A');
$first = xmlwriter_output_memory($w);
xmlwriter_write_element($w, 'item', 'B');
xmlwriter_end_element($w);
$second = xmlwriter_output_memory($w);
echo $first . $second, "
";

<items><item>A</item><item>B</item></items>

Соседние операции: XMLWriter::flush(), XMLWriter::openMemory().

• PHP: XMLWriter::outputMemory
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::flush(bool $empty = true): string|int

Протолкнуть накопленные байты в выбранный приёмник и получить результат сброса.

Режим памяти возвращает string; URI/поток — int с результатом libxml (число записанных при сбросе байтов, при отказе отрицательное значение). С PHP 8.0 false больше не возвращается. flush не закрывает теги и не обещает физическую запись на диск уровня fsync, доставку HTTP-клиенту или завершение прокси-буферизации.

string|int означает строку или целое число в зависимости от приёмника. Проверка должна учитывать этот режим: пустая строка и ноль могут быть допустимым результатом, поэтому простое if (!$result) не подходит.

Другая форма вызова с тем же смыслом: xmlwriter_flush(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('ready', 'yes');
$xml = $w->flush(false);
echo $xml, "\n";
echo $w->flush(), "\n";

<ready>yes</ready>
<ready>yes</ready>

<?php
$w = xmlwriter_open_uri(__DIR__ . '/export.xml');
if ($w === false) {
    throw new RuntimeException('Не открыт файл');
}
xmlwriter_write_element($w, 'sku', 'A');
$bytes = xmlwriter_flush($w);
echo is_int($bytes) && $bytes >= 0 ? "Сброс выполнен
" : "Ошибка записи
";
unset($w);
echo file_get_contents(__DIR__ . '/export.xml'), "
";

Сброс выполнен
<sku>A</sku>

Соседние операции: XMLWriter::outputMemory(), XMLWriter::endDocument(), XMLWriter::openUri().

• PHP: XMLWriter::flush
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_flush(XMLWriter $writer, bool $empty = true): string|int

Протолкнуть накопленные байты в выбранный приёмник и получить результат сброса.

Режим памяти возвращает string; URI/поток — int с результатом libxml (число записанных при сбросе байтов, при отказе отрицательное значение). С PHP 8.0 false больше не возвращается. flush не закрывает теги и не обещает физическую запись на диск уровня fsync, доставку HTTP-клиенту или завершение прокси-буферизации.

string|int означает строку или целое число в зависимости от приёмника. Проверка должна учитывать этот режим: пустая строка и ноль могут быть допустимым результатом, поэтому простое if (!$result) не подходит.

Другая форма вызова с тем же смыслом: XMLWriter::flush(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('ready', 'yes');
$xml = $w->flush(false);
echo $xml, "\n";
echo $w->flush(), "\n";

<ready>yes</ready>
<ready>yes</ready>

<?php
$w = xmlwriter_open_uri(__DIR__ . '/export.xml');
if ($w === false) {
    throw new RuntimeException('Не открыт файл');
}
xmlwriter_write_element($w, 'sku', 'A');
$bytes = xmlwriter_flush($w);
echo is_int($bytes) && $bytes >= 0 ? "Сброс выполнен
" : "Ошибка записи
";
unset($w);
echo file_get_contents(__DIR__ . '/export.xml'), "
";

Сброс выполнен
<sku>A</sku>

Соседние операции: XMLWriter::outputMemory(), XMLWriter::endDocument(), XMLWriter::openUri().

• PHP: XMLWriter::flush
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::setIndent(bool $enable): bool

Включить или выключить автоматические отступы при записи.

Возвращает bool. Настройка сбрасывается при открытии writer. Для смешанного содержимого отступы могут добавлять значимые пробелы перед вложенными элементами и переносы: такие документы лучше писать без форматирования.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_set_indent(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->setIndent(true);
$w->setIndentString('  ');
$w->startElement('order');
$w->writeElement('id', '42');
$w->endElement();
echo $w->outputMemory();

<order>
  <id>42</id>
</order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_set_indent($w, false);
xmlwriter_start_element($w, 'p');
xmlwriter_text($w, 'Buy ');
xmlwriter_write_element($w, 'b', 'today');
xmlwriter_text($w, '!');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<p>Buy <b>today</b>!</p>

Соседние операции: XMLWriter::setIndentString(), XMLWriter::openMemory().

• PHP: XMLWriter::setIndent
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_set_indent(XMLWriter $writer, bool $enable): bool

Включить или выключить автоматические отступы при записи.

Возвращает bool. Настройка сбрасывается при открытии writer. Для смешанного содержимого отступы могут добавлять значимые пробелы перед вложенными элементами и переносы: такие документы лучше писать без форматирования.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::setIndent(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->setIndent(true);
$w->setIndentString('  ');
$w->startElement('order');
$w->writeElement('id', '42');
$w->endElement();
echo $w->outputMemory();

<order>
  <id>42</id>
</order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_set_indent($w, false);
xmlwriter_start_element($w, 'p');
xmlwriter_text($w, 'Buy ');
xmlwriter_write_element($w, 'b', 'today');
xmlwriter_text($w, '!');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<p>Buy <b>today</b>!</p>

Соседние операции: XMLWriter::setIndentString(), XMLWriter::openMemory().

• PHP: XMLWriter::setIndent
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::setIndentString(string $indentation): bool

Задать пробельную строку, повторяемую для отступа каждого уровня.

Возвращает bool. Само задание строки не включает форматирование: нужно setIndent(true). При новом открытии настройка сбрасывается. Форматирование меняет байты, поэтому важно для сравнения файлов и подписей; XML-подпись требует своих правил каноникализации.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_set_indent_string(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->setIndent(true);
$w->setIndentString('    ');
$w->startElement('stock');
$w->writeElement('qty', '2');
$w->endElement();
echo $w->outputMemory();

<stock>
    <qty>2</qty>
</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_set_indent($w, true);
xmlwriter_set_indent_string($w, "	");
xmlwriter_start_element($w, 'stock');
xmlwriter_write_element($w, 'qty', '2');
xmlwriter_end_element($w);
echo str_replace("	", '[TAB]', xmlwriter_output_memory($w));

<stock>
[TAB]<qty>2</qty>
</stock>

Соседние операции: XMLWriter::setIndent(), XMLWriter::startElement().

• PHP: XMLWriter::setIndentString
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_set_indent_string(XMLWriter $writer, string $indentation): bool

Задать пробельную строку, повторяемую для отступа каждого уровня.

Возвращает bool. Само задание строки не включает форматирование: нужно setIndent(true). При новом открытии настройка сбрасывается. Форматирование меняет байты, поэтому важно для сравнения файлов и подписей; XML-подпись требует своих правил каноникализации.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::setIndentString(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->setIndent(true);
$w->setIndentString('    ');
$w->startElement('stock');
$w->writeElement('qty', '2');
$w->endElement();
echo $w->outputMemory();

<stock>
    <qty>2</qty>
</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_set_indent($w, true);
xmlwriter_set_indent_string($w, "	");
xmlwriter_start_element($w, 'stock');
xmlwriter_write_element($w, 'qty', '2');
xmlwriter_end_element($w);
echo str_replace("	", '[TAB]', xmlwriter_output_memory($w));

<stock>
[TAB]<qty>2</qty>
</stock>

Соседние операции: XMLWriter::setIndent(), XMLWriter::startElement().

• PHP: XMLWriter::setIndentString
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

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

Начать документ с XML-декларации перед корневым элементом.

Возвращает bool. Сначала открывают приёмник, затем начинают документ. Уже выведенный HTML/BOM/отладочный текст перед декларацией испортит HTTP XML. Нулевой байт в encoding вызывает ValueError с PHP 8.4. Поддержка выходной кодировки зависит от libxml и его преобразователей.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_document(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDocument('1.0', 'UTF-8');
$w->writeElement('title', 'Книга');
$w->endDocument();
echo $w->outputMemory();

<?xml version="1.0" encoding="UTF-8"?>
<title>Книга</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_document($w, '1.0', 'UTF-8', 'yes');
xmlwriter_write_element($w, 'batch', '12');
xmlwriter_end_document($w);
echo xmlwriter_output_memory($w);

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<batch>12</batch>

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
try {
    $w->startDocument('1.0', "UTF-8\0bad");
} catch (ValueError $error) {
    echo "Кодировка не должна содержать NUL\n";
}

Кодировка не должна содержать NUL

Соседние операции: XMLWriter::endDocument(), XMLWriter::writeElement().

• PHP: XMLWriter::startDocument
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

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

Начать документ с XML-декларации перед корневым элементом.

Возвращает bool. Сначала открывают приёмник, затем начинают документ. Уже выведенный HTML/BOM/отладочный текст перед декларацией испортит HTTP XML. Нулевой байт в encoding вызывает ValueError с PHP 8.4. Поддержка выходной кодировки зависит от libxml и его преобразователей.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startDocument(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDocument('1.0', 'UTF-8');
$w->writeElement('title', 'Книга');
$w->endDocument();
echo $w->outputMemory();

<?xml version="1.0" encoding="UTF-8"?>
<title>Книга</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_document($w, '1.0', 'UTF-8', 'yes');
xmlwriter_write_element($w, 'batch', '12');
xmlwriter_end_document($w);
echo xmlwriter_output_memory($w);

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<batch>12</batch>

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
try {
    $w->startDocument('1.0', "UTF-8\0bad");
} catch (ValueError $error) {
    echo "Кодировка не должна содержать NUL\n";
}

Кодировка не должна содержать NUL

Соседние операции: XMLWriter::endDocument(), XMLWriter::writeElement().

• PHP: XMLWriter::startDocument
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endDocument(): bool

Завершить текущий XML-документ после записи его данных.

Возвращает bool, закрывает оставшиеся элементы и выполняет финализацию libxml. Не является валидацией всего XML и не освобождает сам PHP-объект. Для URI отдельно проверьте flush и освободите writer; для памяти получите строку.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_document(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDocument();
$w->startElement('order');
$w->writeElement('id', '42');
$w->endDocument();
echo $w->outputMemory();

<?xml version="1.0"?>
<order><id>42</id></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_document($w, '1.0', 'UTF-8');
xmlwriter_start_element($w, 'stock');
foreach (['A', 'B'] as $sku) {
    xmlwriter_write_element($w, 'sku', $sku);
}
xmlwriter_end_element($w);
xmlwriter_end_document($w);
echo xmlwriter_output_memory($w);

<?xml version="1.0" encoding="UTF-8"?>
<stock><sku>A</sku><sku>B</sku></stock>

Соседние операции: XMLWriter::startDocument(), XMLWriter::endElement(), XMLWriter::flush().

• PHP: XMLWriter::endDocument
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_document(XMLWriter $writer): bool

Завершить текущий XML-документ после записи его данных.

Возвращает bool, закрывает оставшиеся элементы и выполняет финализацию libxml. Не является валидацией всего XML и не освобождает сам PHP-объект. Для URI отдельно проверьте flush и освободите writer; для памяти получите строку.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endDocument(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDocument();
$w->startElement('order');
$w->writeElement('id', '42');
$w->endDocument();
echo $w->outputMemory();

<?xml version="1.0"?>
<order><id>42</id></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_document($w, '1.0', 'UTF-8');
xmlwriter_start_element($w, 'stock');
foreach (['A', 'B'] as $sku) {
    xmlwriter_write_element($w, 'sku', $sku);
}
xmlwriter_end_element($w);
xmlwriter_end_document($w);
echo xmlwriter_output_memory($w);

<?xml version="1.0" encoding="UTF-8"?>
<stock><sku>A</sku><sku>B</sku></stock>

Соседние операции: XMLWriter::startDocument(), XMLWriter::endElement(), XMLWriter::flush().

• PHP: XMLWriter::endDocument
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startElement(string $name): bool

Открыть новый XML-элемент для текста, атрибутов и вложенных узлов.

Возвращает bool. PHP 8 проверяет имя и при недопустимом имени выбрасывает ValueError. Метод оставляет элемент открытым. Атрибуты добавляют до текста/детей; затем закрывают endElement. Для полного простого текстового элемента короче writeElement.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('title');
$w->text('Книга');
$w->endElement();
echo $w->outputMemory(), "\n";

<title>Книга</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
foreach (['A' => '2', 'B' => '1'] as $sku => $qty) {
    xmlwriter_start_element($w, 'item');
    xmlwriter_write_attribute($w, 'sku', $sku);
    xmlwriter_write_element($w, 'qty', $qty);
    xmlwriter_end_element($w); // item
}
xmlwriter_end_element($w); // order
echo xmlwriter_output_memory($w), "
";

<order><item sku="A"><qty>2</qty></item><item sku="B"><qty>1</qty></item></order>

Соседние операции: XMLWriter::endElement(), XMLWriter::writeElement(), XMLWriter::startElementNs().

• PHP: XMLWriter::startElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_element(XMLWriter $writer, string $name): bool

Открыть новый XML-элемент для текста, атрибутов и вложенных узлов.

Возвращает bool. PHP 8 проверяет имя и при недопустимом имени выбрасывает ValueError. Метод оставляет элемент открытым. Атрибуты добавляют до текста/детей; затем закрывают endElement. Для полного простого текстового элемента короче writeElement.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('title');
$w->text('Книга');
$w->endElement();
echo $w->outputMemory(), "\n";

<title>Книга</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
foreach (['A' => '2', 'B' => '1'] as $sku => $qty) {
    xmlwriter_start_element($w, 'item');
    xmlwriter_write_attribute($w, 'sku', $sku);
    xmlwriter_write_element($w, 'qty', $qty);
    xmlwriter_end_element($w); // item
}
xmlwriter_end_element($w); // order
echo xmlwriter_output_memory($w), "
";

<order><item sku="A"><qty>2</qty></item><item sku="B"><qty>1</qty></item></order>

Соседние операции: XMLWriter::endElement(), XMLWriter::writeElement(), XMLWriter::startElementNs().

• PHP: XMLWriter::startElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endElement(): bool

Закрыть последний открытый элемент и продолжить на уровне родителя.

Возвращает bool. Имя элемента не передают: метод использует внутренний стек. Пустой элемент может стать <note/>. Для обязательного отдельного закрывающего тега применяется fullEndElement. Лишнее закрытие или неправильный контекст может вернуть false.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('note');
$w->endElement();
echo $w->outputMemory(), "\n";

<note/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
foreach (['A' => '2', 'B' => '1'] as $sku => $qty) {
    xmlwriter_start_element($w, 'item');
    xmlwriter_write_attribute($w, 'sku', $sku);
    xmlwriter_write_element($w, 'qty', $qty);
    xmlwriter_end_element($w); // item
}
xmlwriter_end_element($w); // order
echo xmlwriter_output_memory($w), "
";

<order><item sku="A"><qty>2</qty></item><item sku="B"><qty>1</qty></item></order>

Соседние операции: XMLWriter::startElement(), XMLWriter::fullEndElement(), XMLWriter::endDocument().

• PHP: XMLWriter::endElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_element(XMLWriter $writer): bool

Закрыть последний открытый элемент и продолжить на уровне родителя.

Возвращает bool. Имя элемента не передают: метод использует внутренний стек. Пустой элемент может стать <note/>. Для обязательного отдельного закрывающего тега применяется fullEndElement. Лишнее закрытие или неправильный контекст может вернуть false.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('note');
$w->endElement();
echo $w->outputMemory(), "\n";

<note/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
foreach (['A' => '2', 'B' => '1'] as $sku => $qty) {
    xmlwriter_start_element($w, 'item');
    xmlwriter_write_attribute($w, 'sku', $sku);
    xmlwriter_write_element($w, 'qty', $qty);
    xmlwriter_end_element($w); // item
}
xmlwriter_end_element($w); // order
echo xmlwriter_output_memory($w), "
";

<order><item sku="A"><qty>2</qty></item><item sku="B"><qty>1</qty></item></order>

Соседние операции: XMLWriter::startElement(), XMLWriter::fullEndElement(), XMLWriter::endDocument().

• PHP: XMLWriter::endElement
• PHP 8.5.11: реализация

PHP 5.2.0; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::fullEndElement(): bool

Закрыть элемент отдельным завершающим тегом, даже если он пуст.

Возвращает bool. Работает с текущим открытым элементом и не принимает его имя. XML-смысл пустого элемента сохраняется; меняется только представление. Доступен с PHP 5.2.0.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_full_end_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('note');
$w->fullEndElement();
echo $w->outputMemory(), "\n";

<note></note>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'contacts');
foreach (['', 'desk@example.test'] as $email) {
    xmlwriter_start_element($w, 'email');
    if ($email !== '') {
        xmlwriter_text($w, $email);
    }
    xmlwriter_full_end_element($w);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<contacts><email></email><email>desk@example.test</email></contacts>

Соседние операции: XMLWriter::endElement(), XMLWriter::writeElement().

• PHP: XMLWriter::fullEndElement
• PHP 8.5.11: реализация

PHP 5.2.0; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_full_end_element(XMLWriter $writer): bool

Закрыть элемент отдельным завершающим тегом, даже если он пуст.

Возвращает bool. Работает с текущим открытым элементом и не принимает его имя. XML-смысл пустого элемента сохраняется; меняется только представление. Доступен с PHP 5.2.0.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::fullEndElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('note');
$w->fullEndElement();
echo $w->outputMemory(), "\n";

<note></note>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'contacts');
foreach (['', 'desk@example.test'] as $email) {
    xmlwriter_start_element($w, 'email');
    if ($email !== '') {
        xmlwriter_text($w, $email);
    }
    xmlwriter_full_end_element($w);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<contacts><email></email><email>desk@example.test</email></contacts>

Соседние операции: XMLWriter::endElement(), XMLWriter::writeElement().

• PHP: XMLWriter::fullEndElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeElement(string $name, ?string $content = null): bool

Записать и сразу закрыть элемент с обычным текстом.

Возвращает bool. Не создаёт вложенные узлы из строки <b>...: строка будет текстом. Недопустимое имя вызывает ValueError в PHP 8. Для узла с атрибутами/детьми используйте startElement и отдельные операции.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('title', 'Paper & pen');
echo $w->outputMemory(), "\n";

<title>Paper &amp; pen</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'fields');
xmlwriter_write_element($w, 'omitted');
xmlwriter_write_element($w, 'nullValue', null);
xmlwriter_write_element($w, 'emptyText', '');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<fields><omitted/><nullValue/><emptyText></emptyText></fields>

Соседние операции: XMLWriter::startElement(), XMLWriter::text(), XMLWriter::writeRaw().

• PHP: XMLWriter::writeElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_element(XMLWriter $writer, string $name, ?string $content = null): bool

Записать и сразу закрыть элемент с обычным текстом.

Возвращает bool. Не создаёт вложенные узлы из строки <b>...: строка будет текстом. Недопустимое имя вызывает ValueError в PHP 8. Для узла с атрибутами/детьми используйте startElement и отдельные операции.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeElement('title', 'Paper & pen');
echo $w->outputMemory(), "\n";

<title>Paper &amp; pen</title>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'fields');
xmlwriter_write_element($w, 'omitted');
xmlwriter_write_element($w, 'nullValue', null);
xmlwriter_write_element($w, 'emptyText', '');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<fields><omitted/><nullValue/><emptyText></emptyText></fields>

Соседние операции: XMLWriter::startElement(), XMLWriter::text(), XMLWriter::writeRaw().

• PHP: XMLWriter::writeElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startAttribute(string $name): bool

Начать атрибут, значение которого удобнее записать несколькими частями.

Возвращает bool. Вызов допустим в начале элемента до его текста/детей. Неверное имя — ValueError в PHP 8. Не начинайте второй атрибут до завершения первого. Готовое значение проще передать writeAttribute.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_attribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttribute('label');
$w->text('A');
$w->text(' & B');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="A &amp; B"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_start_attribute($w, 'id');
xmlwriter_text($w, 'SHOP-');
xmlwriter_text($w, '42');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'ready');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<order id="SHOP-42">ready</order>

Соседние операции: XMLWriter::endAttribute(), XMLWriter::writeAttribute(), XMLWriter::startAttributeNs().

• PHP: XMLWriter::startAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_attribute(XMLWriter $writer, string $name): bool

Начать атрибут, значение которого удобнее записать несколькими частями.

Возвращает bool. Вызов допустим в начале элемента до его текста/детей. Неверное имя — ValueError в PHP 8. Не начинайте второй атрибут до завершения первого. Готовое значение проще передать writeAttribute.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startAttribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttribute('label');
$w->text('A');
$w->text(' & B');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="A &amp; B"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_start_attribute($w, 'id');
xmlwriter_text($w, 'SHOP-');
xmlwriter_text($w, '42');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'ready');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<order id="SHOP-42">ready</order>

Соседние операции: XMLWriter::endAttribute(), XMLWriter::writeAttribute(), XMLWriter::startAttributeNs().

• PHP: XMLWriter::startAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endAttribute(): bool

Закончить текущее значение атрибута перед следующим атрибутом или текстом элемента.

Возвращает bool. Не закрывает элемент. Если атрибут не открыт, операция может вернуть false. Не нужно вручную вставлять завершающую кавычку: её сформирует writer.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_attribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttribute('label');
$w->text('A');
$w->text(' & B');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="A &amp; B"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_start_attribute($w, 'id');
xmlwriter_text($w, 'SHOP-');
xmlwriter_text($w, '42');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'ready');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<order id="SHOP-42">ready</order>

Соседние операции: XMLWriter::startAttribute(), XMLWriter::startAttributeNs(), XMLWriter::writeAttribute().

• PHP: XMLWriter::endAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_attribute(XMLWriter $writer): bool

Закончить текущее значение атрибута перед следующим атрибутом или текстом элемента.

Возвращает bool. Не закрывает элемент. Если атрибут не открыт, операция может вернуть false. Не нужно вручную вставлять завершающую кавычку: её сформирует writer.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endAttribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttribute('label');
$w->text('A');
$w->text(' & B');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="A &amp; B"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_start_attribute($w, 'id');
xmlwriter_text($w, 'SHOP-');
xmlwriter_text($w, '42');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'ready');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<order id="SHOP-42">ready</order>

Соседние операции: XMLWriter::startAttribute(), XMLWriter::startAttributeNs(), XMLWriter::writeAttribute().

• PHP: XMLWriter::endAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeAttribute(string $name, string $value): bool

Записать готовый атрибут внутри ещё открытого начального тега.

Возвращает bool. После текста или первого дочернего элемента возвращает false. Имя проверяется и в PHP 8 может вызвать ValueError. Повторяющиеся одноимённые атрибуты недопустимы в XML: не используйте writer как хранилище с перезаписью ключа.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_attribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->writeAttribute('label', 'Set "A" & pen');
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="Set &quot;A&quot; &amp; pen"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'total', '499');
var_dump(xmlwriter_write_attribute($w, 'id', '42'));
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

bool(false)
<order><total>499</total></order>

Соседние операции: XMLWriter::startAttribute(), XMLWriter::writeAttributeNs(), XMLWriter::startElement().

• PHP: XMLWriter::writeAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_attribute(XMLWriter $writer, string $name, string $value): bool

Записать готовый атрибут внутри ещё открытого начального тега.

Возвращает bool. После текста или первого дочернего элемента возвращает false. Имя проверяется и в PHP 8 может вызвать ValueError. Повторяющиеся одноимённые атрибуты недопустимы в XML: не используйте writer как хранилище с перезаписью ключа.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeAttribute(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->writeAttribute('label', 'Set "A" & pen');
$w->endElement();
echo $w->outputMemory(), "\n";

<item label="Set &quot;A&quot; &amp; pen"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'total', '499');
var_dump(xmlwriter_write_attribute($w, 'id', '42'));
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

bool(false)
<order><total>499</total></order>

Соседние операции: XMLWriter::startAttribute(), XMLWriter::writeAttributeNs(), XMLWriter::startElement().

• PHP: XMLWriter::writeAttribute
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startElementNs(?string $prefix, string $name, ?string $namespace): bool

Начать элемент, связанный с XML-пространством имён.

Возвращает bool; неправильное имя — ValueError в PHP 8. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_element_ns(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs('s', 'order', 'urn:shop:shipping');
$w->writeElementNs('s', 'id', null, '42');
$w->endElement();
echo $w->outputMemory(), "\n";

<s:order xmlns:s="urn:shop:shipping"><s:id>42</s:id></s:order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element_ns($w, null, 'catalog', 'urn:shop:catalog');
xmlwriter_write_element_ns($w, null, 'sku', null, 'A');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<catalog xmlns="urn:shop:catalog"><sku>A</sku></catalog>

Соседние операции: XMLWriter::writeElementNs(), XMLWriter::endElement(), XMLWriter::writeAttributeNs().

• PHP: XMLWriter::startElementNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_element_ns(XMLWriter $writer, ?string $prefix, string $name, ?string $namespace): bool

Начать элемент, связанный с XML-пространством имён.

Возвращает bool; неправильное имя — ValueError в PHP 8. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startElementNs(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs('s', 'order', 'urn:shop:shipping');
$w->writeElementNs('s', 'id', null, '42');
$w->endElement();
echo $w->outputMemory(), "\n";

<s:order xmlns:s="urn:shop:shipping"><s:id>42</s:id></s:order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element_ns($w, null, 'catalog', 'urn:shop:catalog');
xmlwriter_write_element_ns($w, null, 'sku', null, 'A');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<catalog xmlns="urn:shop:catalog"><sku>A</sku></catalog>

Соседние операции: XMLWriter::writeElementNs(), XMLWriter::endElement(), XMLWriter::writeAttributeNs().

• PHP: XMLWriter::startElementNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeElementNs(?string $prefix, string $name, ?string $namespace, ?string $content = null): bool

Записать полный текстовый элемент с XML-пространством имён.

Возвращает bool. Текст экранируется, готовая вложенная разметка из него не создаётся. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_element_ns(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs('s', 'order', 'urn:shop:shipping');
$w->writeElementNs('s', 'id', null, '42');
$w->endElement();
echo $w->outputMemory(), "\n";

<s:order xmlns:s="urn:shop:shipping"><s:id>42</s:id></s:order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element_ns($w, null, 'catalog', 'urn:shop:catalog');
xmlwriter_write_element_ns($w, null, 'sku', null, 'A');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<catalog xmlns="urn:shop:catalog"><sku>A</sku></catalog>

Соседние операции: XMLWriter::startElementNs(), XMLWriter::writeElement(), XMLWriter::writeAttributeNs().

• PHP: XMLWriter::writeElementNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_element_ns(XMLWriter $writer, ?string $prefix, string $name, ?string $namespace, ?string $content = null): bool

Записать полный текстовый элемент с XML-пространством имён.

Возвращает bool. Текст экранируется, готовая вложенная разметка из него не создаётся. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeElementNs(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs('s', 'order', 'urn:shop:shipping');
$w->writeElementNs('s', 'id', null, '42');
$w->endElement();
echo $w->outputMemory(), "\n";

<s:order xmlns:s="urn:shop:shipping"><s:id>42</s:id></s:order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element_ns($w, null, 'catalog', 'urn:shop:catalog');
xmlwriter_write_element_ns($w, null, 'sku', null, 'A');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<catalog xmlns="urn:shop:catalog"><sku>A</sku></catalog>

Соседние операции: XMLWriter::startElementNs(), XMLWriter::writeElement(), XMLWriter::writeAttributeNs().

• PHP: XMLWriter::writeElementNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startAttributeNs(?string $prefix, string $name, ?string $namespace): bool

Начать значение атрибута с префиксом и namespace, чтобы дописать его частями.

Возвращает bool. Только до содержимого элемента; заканчивается endAttribute. prefix допускает null с PHP 8.0; это не способ включить атрибут в default namespace. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_attribute_ns(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttributeNs('s', 'code', 'urn:shop:ids');
$w->text('A-');
$w->text('12');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item s:code="A-12" xmlns:s="urn:shop:ids"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'title');
xmlwriter_start_attribute_ns($w, 'xml', 'lang', null);
xmlwriter_text($w, 'ru');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'Книга');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<title xml:lang="ru">Книга</title>

Соседние операции: XMLWriter::endAttribute(), XMLWriter::writeAttributeNs(), XMLWriter::startAttribute().

• PHP: XMLWriter::startAttributeNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_attribute_ns(XMLWriter $writer, ?string $prefix, string $name, ?string $namespace): bool

Начать значение атрибута с префиксом и namespace, чтобы дописать его частями.

Возвращает bool. Только до содержимого элемента; заканчивается endAttribute. prefix допускает null с PHP 8.0; это не способ включить атрибут в default namespace. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startAttributeNs(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('item');
$w->startAttributeNs('s', 'code', 'urn:shop:ids');
$w->text('A-');
$w->text('12');
$w->endAttribute();
$w->endElement();
echo $w->outputMemory(), "\n";

<item s:code="A-12" xmlns:s="urn:shop:ids"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'title');
xmlwriter_start_attribute_ns($w, 'xml', 'lang', null);
xmlwriter_text($w, 'ru');
xmlwriter_end_attribute($w);
xmlwriter_text($w, 'Книга');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<title xml:lang="ru">Книга</title>

Соседние операции: XMLWriter::endAttribute(), XMLWriter::writeAttributeNs(), XMLWriter::startAttribute().

• PHP: XMLWriter::startAttributeNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeAttributeNs(?string $prefix, string $name, ?string $namespace, string $value): bool

Записать готовый атрибут с XML-пространством имён.

Возвращает bool. Только до текста/детей, иначе отказ. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_attribute_ns(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs(null, 'item', 'urn:shop:catalog');
$w->writeAttribute('id', '7');
$w->writeAttributeNs('crm', 'id', 'urn:shop:crm', '90');
$w->endElement();
echo $w->outputMemory(), "\n";

<item id="7" crm:id="90" xmlns:crm="urn:shop:crm" xmlns="urn:shop:catalog"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'label');
xmlwriter_write_attribute_ns($w, 'xml', 'space', null, 'preserve');
xmlwriter_text($w, '  A  ');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<label xml:space="preserve">  A  </label>

Соседние операции: XMLWriter::startAttributeNs(), XMLWriter::writeAttribute(), XMLWriter::startElementNs().

• PHP: XMLWriter::writeAttributeNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_attribute_ns(XMLWriter $writer, ?string $prefix, string $name, ?string $namespace, string $value): bool

Записать готовый атрибут с XML-пространством имён.

Возвращает bool. Только до текста/детей, иначе отказ. URI пространства имён служит идентификатором и сам по себе не скачивается. null для prefix убирает префикс, но при заданном URI элемент может получить default namespace через xmlns. Непрефиксные атрибуты не наследуют default namespace. Для принадлежности атрибута пространству задавайте явный префикс. XMLWriter не ведёт за вас полную проверку области видимости всех префиксов.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeAttributeNs(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElementNs(null, 'item', 'urn:shop:catalog');
$w->writeAttribute('id', '7');
$w->writeAttributeNs('crm', 'id', 'urn:shop:crm', '90');
$w->endElement();
echo $w->outputMemory(), "\n";

<item id="7" crm:id="90" xmlns:crm="urn:shop:crm" xmlns="urn:shop:catalog"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'label');
xmlwriter_write_attribute_ns($w, 'xml', 'space', null, 'preserve');
xmlwriter_text($w, '  A  ');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<label xml:space="preserve">  A  </label>

Соседние операции: XMLWriter::startAttributeNs(), XMLWriter::writeAttribute(), XMLWriter::startElementNs().

• PHP: XMLWriter::writeAttributeNs
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::text(string $content): bool

Дополнить текущее текстовое содержимое или открытое значение атрибута.

Возвращает bool. В обычном тексте/атрибуте экранирует специальные XML-символы; точная запись кавычек зависит от контекста libxml. В открытых CDATA/комментарии/PI действует контекст такой конструкции: text не превращает запрещённые последовательности в безопасный комментарий или CDATA. Управляющие символы, недопустимые в XML 1.0, и неверную кодировку нужно отклонить/преобразовать согласно договору приложения.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_text(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->text('A < B & C > D');
$w->endElement();
echo $w->outputMemory(), "\n";

<description>A &lt; B &amp; C &gt; D</description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'url');
xmlwriter_text($w, 'https://shop.example.test/?sku=A&qty=2');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<url>https://shop.example.test/?sku=A&amp;qty=2</url>

Соседние операции: XMLWriter::writeElement(), XMLWriter::writeRaw(), XMLWriter::writeCdata().

• PHP: XMLWriter::text
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_text(XMLWriter $writer, string $content): bool

Дополнить текущее текстовое содержимое или открытое значение атрибута.

Возвращает bool. В обычном тексте/атрибуте экранирует специальные XML-символы; точная запись кавычек зависит от контекста libxml. В открытых CDATA/комментарии/PI действует контекст такой конструкции: text не превращает запрещённые последовательности в безопасный комментарий или CDATA. Управляющие символы, недопустимые в XML 1.0, и неверную кодировку нужно отклонить/преобразовать согласно договору приложения.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::text(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->text('A < B & C > D');
$w->endElement();
echo $w->outputMemory(), "\n";

<description>A &lt; B &amp; C &gt; D</description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'url');
xmlwriter_text($w, 'https://shop.example.test/?sku=A&qty=2');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<url>https://shop.example.test/?sku=A&amp;qty=2</url>

Соседние операции: XMLWriter::writeElement(), XMLWriter::writeRaw(), XMLWriter::writeCdata().

• PHP: XMLWriter::text
• PHP 8.5.11: реализация

PHP 5.2.0; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeRaw(string $content): bool

Вставить уже подготовленную XML-разметку без экранирования.

Возвращает bool, но true не означает well-formed результат: writer не проверяет баланс/пространства фрагмента. Значения из формы/БД передавайте text или writeElement. Raw-фрагмент не меняет внутренний стек start/end как последовательность вызовов. Доступен с PHP 5.2.0.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_raw(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->writeRaw('<b>New</b>');
$w->endElement();
echo $w->outputMemory(), "\n";

<description><b>New</b></description>

<?php
$fragment = xmlwriter_open_memory();
$w = xmlwriter_open_memory();
if ($fragment === false || $w === false) {
    throw new RuntimeException('Нет буфера');
}
xmlwriter_write_element($fragment, 'title', 'A & B');
$trustedXml = xmlwriter_output_memory($fragment);
xmlwriter_start_element($w, 'item');
xmlwriter_write_raw($w, $trustedXml);
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<item><title>A &amp; B</title></item>

Соседние операции: XMLWriter::text(), XMLWriter::writeElement(), XMLWriter::writeCdata().

• PHP: XMLWriter::writeRaw
• PHP 8.5.11: реализация

PHP 5.2.0; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_raw(XMLWriter $writer, string $content): bool

Вставить уже подготовленную XML-разметку без экранирования.

Возвращает bool, но true не означает well-formed результат: writer не проверяет баланс/пространства фрагмента. Значения из формы/БД передавайте text или writeElement. Raw-фрагмент не меняет внутренний стек start/end как последовательность вызовов. Доступен с PHP 5.2.0.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeRaw(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->writeRaw('<b>New</b>');
$w->endElement();
echo $w->outputMemory(), "\n";

<description><b>New</b></description>

<?php
$fragment = xmlwriter_open_memory();
$w = xmlwriter_open_memory();
if ($fragment === false || $w === false) {
    throw new RuntimeException('Нет буфера');
}
xmlwriter_write_element($fragment, 'title', 'A & B');
$trustedXml = xmlwriter_output_memory($fragment);
xmlwriter_start_element($w, 'item');
xmlwriter_write_raw($w, $trustedXml);
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<item><title>A &amp; B</title></item>

Соседние операции: XMLWriter::text(), XMLWriter::writeElement(), XMLWriter::writeCdata().

• PHP: XMLWriter::writeRaw
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startCdata(): bool

Начать CDATA-секцию, чтобы записать текст без XML-экранирования по частям.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет. До этого откройте элемент; startCdata не принимает имя элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_cdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->startCdata();
$w->text('<b>New</b>');
$w->text(' & useful');
$w->endCdata();
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<b>New</b> & useful]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'description');
xmlwriter_start_cdata($w);
xmlwriter_text($w, '<b>New</b>');
xmlwriter_end_cdata($w);
xmlwriter_text($w, ' & useful');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description><![CDATA[<b>New</b>]]> &amp; useful</description>

Соседние операции: XMLWriter::endCdata(), XMLWriter::writeCdata(), XMLWriter::text().

• PHP: XMLWriter::startCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_cdata(XMLWriter $writer): bool

Начать CDATA-секцию, чтобы записать текст без XML-экранирования по частям.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет. До этого откройте элемент; startCdata не принимает имя элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startCdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->startCdata();
$w->text('<b>New</b>');
$w->text(' & useful');
$w->endCdata();
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<b>New</b> & useful]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'description');
xmlwriter_start_cdata($w);
xmlwriter_text($w, '<b>New</b>');
xmlwriter_end_cdata($w);
xmlwriter_text($w, ' & useful');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description><![CDATA[<b>New</b>]]> &amp; useful</description>

Соседние операции: XMLWriter::endCdata(), XMLWriter::writeCdata(), XMLWriter::text().

• PHP: XMLWriter::startCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endCdata(): bool

Закончить текущую CDATA-секцию и вернуться к записи содержимого элемента.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет. Без открытой секции возможен false; endCdata не заменяет endElement.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_cdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->startCdata();
$w->text('<b>New</b>');
$w->text(' & useful');
$w->endCdata();
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<b>New</b> & useful]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'description');
xmlwriter_start_cdata($w);
xmlwriter_text($w, '<b>New</b>');
xmlwriter_end_cdata($w);
xmlwriter_text($w, ' & useful');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description><![CDATA[<b>New</b>]]> &amp; useful</description>

Соседние операции: XMLWriter::startCdata(), XMLWriter::writeCdata(), XMLWriter::endElement().

• PHP: XMLWriter::endCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_cdata(XMLWriter $writer): bool

Закончить текущую CDATA-секцию и вернуться к записи содержимого элемента.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет. Без открытой секции возможен false; endCdata не заменяет endElement.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endCdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->startCdata();
$w->text('<b>New</b>');
$w->text(' & useful');
$w->endCdata();
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<b>New</b> & useful]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'description');
xmlwriter_start_cdata($w);
xmlwriter_text($w, '<b>New</b>');
xmlwriter_end_cdata($w);
xmlwriter_text($w, ' & useful');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description><![CDATA[<b>New</b>]]> &amp; useful</description>

Соседние операции: XMLWriter::startCdata(), XMLWriter::writeCdata(), XMLWriter::endElement().

• PHP: XMLWriter::endCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeCdata(string $content): bool

Записать полный CDATA-блок внутри элемента за один вызов.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_cdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->writeCdata('<p>A & B</p>');
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<p>A & B</p>]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$description = 'The marker ]]> is part of the manual';
xmlwriter_start_element($w, 'description');
if (str_contains($description, ']]>')) {
    xmlwriter_text($w, $description);
} else {
    xmlwriter_write_cdata($w, $description);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description>The marker ]]&gt; is part of the manual</description>

Соседние операции: XMLWriter::startCdata(), XMLWriter::endCdata(), XMLWriter::text().

• PHP: XMLWriter::writeCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_cdata(XMLWriter $writer, string $content): bool

Записать полный CDATA-блок внутри элемента за один вызов.

Возвращает bool. Последовательность ]]> не может находиться внутри одной CDATA-секции. Не полагайтесь на автоматическое разбиение libxml: для произвольных данных проще обычный text. Неверный UTF-8 и недопустимые XML-символы CDATA не исправляет.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeCdata(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startElement('description');
$w->writeCdata('<p>A & B</p>');
$w->endElement();
echo $w->outputMemory(), "\n";

<description><![CDATA[<p>A & B</p>]]></description>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$description = 'The marker ]]> is part of the manual';
xmlwriter_start_element($w, 'description');
if (str_contains($description, ']]>')) {
    xmlwriter_text($w, $description);
} else {
    xmlwriter_write_cdata($w, $description);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<description>The marker ]]&gt; is part of the manual</description>

Соседние операции: XMLWriter::startCdata(), XMLWriter::endCdata(), XMLWriter::text().

• PHP: XMLWriter::writeCdata
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startComment(): bool

Начать служебный XML-комментарий, который формируется несколькими записями.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_comment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startComment();
$w->text('Batch ');
$w->text('42');
$w->endComment();
$w->writeElement('stock', '7');
echo $w->outputMemory(), "\n";

<!--Batch 42--><stock>7</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'stock');
xmlwriter_start_comment($w);
xmlwriter_text($w, 'Quantity after reservation');
xmlwriter_end_comment($w);
xmlwriter_write_element($w, 'qty', '7');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<stock><!--Quantity after reservation--><qty>7</qty></stock>

Соседние операции: XMLWriter::endComment(), XMLWriter::writeComment(), XMLWriter::text().

• PHP: XMLWriter::startComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_comment(XMLWriter $writer): bool

Начать служебный XML-комментарий, который формируется несколькими записями.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startComment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startComment();
$w->text('Batch ');
$w->text('42');
$w->endComment();
$w->writeElement('stock', '7');
echo $w->outputMemory(), "\n";

<!--Batch 42--><stock>7</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'stock');
xmlwriter_start_comment($w);
xmlwriter_text($w, 'Quantity after reservation');
xmlwriter_end_comment($w);
xmlwriter_write_element($w, 'qty', '7');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<stock><!--Quantity after reservation--><qty>7</qty></stock>

Соседние операции: XMLWriter::endComment(), XMLWriter::writeComment(), XMLWriter::text().

• PHP: XMLWriter::startComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endComment(): bool

Закончить текущий комментарий перед дальнейшей XML-разметкой.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи. Никаких параметров, включая текст или имя, у метода нет.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_comment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startComment();
$w->text('Batch ');
$w->text('42');
$w->endComment();
$w->writeElement('stock', '7');
echo $w->outputMemory(), "\n";

<!--Batch 42--><stock>7</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'stock');
xmlwriter_start_comment($w);
xmlwriter_text($w, 'Quantity after reservation');
xmlwriter_end_comment($w);
xmlwriter_write_element($w, 'qty', '7');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<stock><!--Quantity after reservation--><qty>7</qty></stock>

Соседние операции: XMLWriter::startComment(), XMLWriter::writeComment().

• PHP: XMLWriter::endComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_comment(XMLWriter $writer): bool

Закончить текущий комментарий перед дальнейшей XML-разметкой.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи. Никаких параметров, включая текст или имя, у метода нет.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endComment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startComment();
$w->text('Batch ');
$w->text('42');
$w->endComment();
$w->writeElement('stock', '7');
echo $w->outputMemory(), "\n";

<!--Batch 42--><stock>7</stock>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_element($w, 'stock');
xmlwriter_start_comment($w);
xmlwriter_text($w, 'Quantity after reservation');
xmlwriter_end_comment($w);
xmlwriter_write_element($w, 'qty', '7');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<stock><!--Quantity after reservation--><qty>7</qty></stock>

Соседние операции: XMLWriter::startComment(), XMLWriter::writeComment().

• PHP: XMLWriter::endComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeComment(string $content): bool

Записать полный XML-комментарий одной операцией.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_comment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeComment('Export schema v2');
$w->writeElement('order', '42');
echo $w->outputMemory(), "\n";

<!--Export schema v2--><order>42</order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$label = 'Batch -- 42';
if (str_contains($label, '--') || str_ends_with($label, '-')) {
    echo "Метка не подходит для XML-комментария
";
} else {
    xmlwriter_write_comment($w, $label);
}
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

Метка не подходит для XML-комментария
<order>42</order>

Соседние операции: XMLWriter::startComment(), XMLWriter::endComment(), XMLWriter::text().

• PHP: XMLWriter::writeComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_comment(XMLWriter $writer, string $content): bool

Записать полный XML-комментарий одной операцией.

Возвращает bool. XML-комментарий не допускает -- внутри и дефис непосредственно перед завершающей границей. text в этом режиме не делает произвольную строку безопасным комментарием. Значение следует ограничить или проверить до записи.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeComment(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeComment('Export schema v2');
$w->writeElement('order', '42');
echo $w->outputMemory(), "\n";

<!--Export schema v2--><order>42</order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$label = 'Batch -- 42';
if (str_contains($label, '--') || str_ends_with($label, '-')) {
    echo "Метка не подходит для XML-комментария
";
} else {
    xmlwriter_write_comment($w, $label);
}
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

Метка не подходит для XML-комментария
<order>42</order>

Соседние операции: XMLWriter::startComment(), XMLWriter::endComment(), XMLWriter::text().

• PHP: XMLWriter::writeComment
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startPi(string $target): bool

Начать инструкцию обработки для получателя XML.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_pi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startPi('xml-stylesheet');
$w->text('type="text/xsl" ');
$w->text('href="catalog.xsl"');
$w->endPi();
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_pi($w, 'shop-export');
xmlwriter_text($w, 'version="2"');
xmlwriter_end_pi($w);
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

<?shop-export version="2"?><order>42</order>

Соседние операции: XMLWriter::endPi(), XMLWriter::writePi(), XMLWriter::startDocument().

• PHP: XMLWriter::startPi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_pi(XMLWriter $writer, string $target): bool

Начать инструкцию обработки для получателя XML.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startPi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startPi('xml-stylesheet');
$w->text('type="text/xsl" ');
$w->text('href="catalog.xsl"');
$w->endPi();
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_pi($w, 'shop-export');
xmlwriter_text($w, 'version="2"');
xmlwriter_end_pi($w);
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

<?shop-export version="2"?><order>42</order>

Соседние операции: XMLWriter::endPi(), XMLWriter::writePi(), XMLWriter::startDocument().

• PHP: XMLWriter::startPi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endPi(): bool

Закончить текущую инструкцию обработки.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные. Метод не закрывает элемент и не запускает обработчик.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_pi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startPi('xml-stylesheet');
$w->text('type="text/xsl" ');
$w->text('href="catalog.xsl"');
$w->endPi();
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_pi($w, 'shop-export');
xmlwriter_text($w, 'version="2"');
xmlwriter_end_pi($w);
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

<?shop-export version="2"?><order>42</order>

Соседние операции: XMLWriter::startPi(), XMLWriter::writePi().

• PHP: XMLWriter::endPi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_pi(XMLWriter $writer): bool

Закончить текущую инструкцию обработки.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные. Метод не закрывает элемент и не запускает обработчик.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endPi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startPi('xml-stylesheet');
$w->text('type="text/xsl" ');
$w->text('href="catalog.xsl"');
$w->endPi();
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_pi($w, 'shop-export');
xmlwriter_text($w, 'version="2"');
xmlwriter_end_pi($w);
xmlwriter_write_element($w, 'order', '42');
echo xmlwriter_output_memory($w), "
";

<?shop-export version="2"?><order>42</order>

Соседние операции: XMLWriter::startPi(), XMLWriter::writePi().

• PHP: XMLWriter::endPi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writePi(string $target, string $content): bool

Записать полную инструкцию обработки одной операцией.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_pi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writePi('xml-stylesheet', 'type="text/xsl" href="catalog.xsl"');
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$instruction = 'format="compact"';
if (str_contains($instruction, '?>')) {
    throw new InvalidArgumentException('Граница PI внутри данных');
}
xmlwriter_write_pi($w, 'shop-export', $instruction);
xmlwriter_write_element($w, 'stock', '7');
echo xmlwriter_output_memory($w), "
";

<?shop-export format="compact"?><stock>7</stock>

Соседние операции: XMLWriter::startPi(), XMLWriter::endPi(), XMLWriter::startDocument().

• PHP: XMLWriter::writePi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_pi(XMLWriter $writer, string $target, string $content): bool

Записать полную инструкцию обработки одной операцией.

Возвращает bool. target должен быть допустимым XML-именем; xml в любом регистре зарезервировано для декларации. В содержимом PI запрещена последовательность ?>. Кавычки/псевдоатрибуты в content — ваша строка, а не набор атрибутов XMLWriter. Не передавайте сюда неподготовленные внешние данные.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writePi(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writePi('xml-stylesheet', 'type="text/xsl" href="catalog.xsl"');
$w->writeElement('catalog', 'ready');
echo $w->outputMemory(), "\n";

<?xml-stylesheet type="text/xsl" href="catalog.xsl"?><catalog>ready</catalog>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$instruction = 'format="compact"';
if (str_contains($instruction, '?>')) {
    throw new InvalidArgumentException('Граница PI внутри данных');
}
xmlwriter_write_pi($w, 'shop-export', $instruction);
xmlwriter_write_element($w, 'stock', '7');
echo xmlwriter_output_memory($w), "
";

<?shop-export format="compact"?><stock>7</stock>

Соседние операции: XMLWriter::startPi(), XMLWriter::endPi(), XMLWriter::startDocument().

• PHP: XMLWriter::writePi
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startDtd(string $qualifiedName, ?string $publicId = null, ?string $systemId = null): bool

Начать объявление типа документа и затем дописать внутренние объявления.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. null исключает необязательный идентификатор; имена и идентификаторы являются контролируемой частью формата, не пользовательскими строками.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_dtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'order');
xmlwriter_write_dtd_element($w, 'order', '(id,total)');
xmlwriter_write_dtd_element($w, 'id', '(#PCDATA)');
xmlwriter_write_dtd_element($w, 'total', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'id', '42');
xmlwriter_write_element($w, 'total', '499');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

Соседние операции: XMLWriter::endDtd(), XMLWriter::writeDtd(), XMLWriter::writeDtdElement().

• PHP: XMLWriter::startDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_dtd(XMLWriter $writer, string $qualifiedName, ?string $publicId = null, ?string $systemId = null): bool

Начать объявление типа документа и затем дописать внутренние объявления.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. null исключает необязательный идентификатор; имена и идентификаторы являются контролируемой частью формата, не пользовательскими строками.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startDtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'order');
xmlwriter_write_dtd_element($w, 'order', '(id,total)');
xmlwriter_write_dtd_element($w, 'id', '(#PCDATA)');
xmlwriter_write_dtd_element($w, 'total', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'id', '42');
xmlwriter_write_element($w, 'total', '499');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

Соседние операции: XMLWriter::endDtd(), XMLWriter::writeDtd(), XMLWriter::writeDtdElement().

• PHP: XMLWriter::startDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endDtd(): bool

Закончить объявление типа документа перед его корневым элементом.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. Закрывает DTD, а не документ или элемент; без соответствующего startDtd возможен отказ.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_dtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'order');
xmlwriter_write_dtd_element($w, 'order', '(id,total)');
xmlwriter_write_dtd_element($w, 'id', '(#PCDATA)');
xmlwriter_write_dtd_element($w, 'total', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'id', '42');
xmlwriter_write_element($w, 'total', '499');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

Соседние операции: XMLWriter::startDtd(), XMLWriter::writeDtd().

• PHP: XMLWriter::endDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_dtd(XMLWriter $writer): bool

Закончить объявление типа документа перед его корневым элементом.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. Закрывает DTD, а не документ или элемент; без соответствующего startDtd возможен отказ.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endDtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'order');
xmlwriter_write_dtd_element($w, 'order', '(id,total)');
xmlwriter_write_dtd_element($w, 'id', '(#PCDATA)');
xmlwriter_write_dtd_element($w, 'total', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'order');
xmlwriter_write_element($w, 'id', '42');
xmlwriter_write_element($w, 'total', '499');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

Соседние операции: XMLWriter::startDtd(), XMLWriter::writeDtd().

• PHP: XMLWriter::endDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeDtd(string $name, ?string $publicId = null, ?string $systemId = null, ?string $content = null): bool

Записать полный DOCTYPE с внешними идентификаторами и/или внутренним набором объявлений.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. Готовый content не проверяется как вся DTD, поэтому сложные правила удобнее собирать отдельными DTD-операциями.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_dtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeDtd('message', null, null, '<!ELEMENT message (#PCDATA)>');
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_write_dtd($w, 'catalog', '-//Example Shop//DTD Catalog 1.0//EN', 'catalog.dtd');
xmlwriter_write_element($w, 'catalog');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog PUBLIC "-//Example Shop//DTD Catalog 1.0//EN" "catalog.dtd"><catalog/>

Соседние операции: XMLWriter::startDtd(), XMLWriter::writeDtdElement(), XMLWriter::writeDtdAttlist().

• PHP: XMLWriter::writeDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_dtd(XMLWriter $writer, string $name, ?string $publicId = null, ?string $systemId = null, ?string $content = null): bool

Записать полный DOCTYPE с внешними идентификаторами и/или внутренним набором объявлений.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Возвращает bool. Готовый content не проверяется как вся DTD, поэтому сложные правила удобнее собирать отдельными DTD-операциями.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeDtd(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->writeDtd('message', null, null, '<!ELEMENT message (#PCDATA)>');
$w->writeElement('message', 'Ready');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Ready</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_write_dtd($w, 'catalog', '-//Example Shop//DTD Catalog 1.0//EN', 'catalog.dtd');
xmlwriter_write_element($w, 'catalog');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog PUBLIC "-//Example Shop//DTD Catalog 1.0//EN" "catalog.dtd"><catalog/>

Соседние операции: XMLWriter::startDtd(), XMLWriter::writeDtdElement(), XMLWriter::writeDtdAttlist().

• PHP: XMLWriter::writeDtd
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startDtdElement(string $qualifiedName): bool

Начать объявление допустимого содержимого конкретного элемента в DTD.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_dtd_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('order');
$w->startDtdElement('order');
$w->text('(id,');
$w->text('total)');
$w->endDtdElement();
$w->writeDtdElement('id', '(#PCDATA)');
$w->writeDtdElement('total', '(#PCDATA)');
$w->endDtd();
$w->startElement('order');
$w->writeElement('id', '42');
$w->writeElement('total', '499');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'ping');
xmlwriter_start_dtd_element($w, 'ping');
xmlwriter_text($w, 'EMPTY');
xmlwriter_end_dtd_element($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'ping');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE ping [<!ELEMENT ping EMPTY>]><ping/>

Соседние операции: XMLWriter::endDtdElement(), XMLWriter::writeDtdElement(), XMLWriter::startElement().

• PHP: XMLWriter::startDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_dtd_element(XMLWriter $writer, string $qualifiedName): bool

Начать объявление допустимого содержимого конкретного элемента в DTD.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startDtdElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('order');
$w->startDtdElement('order');
$w->text('(id,');
$w->text('total)');
$w->endDtdElement();
$w->writeDtdElement('id', '(#PCDATA)');
$w->writeDtdElement('total', '(#PCDATA)');
$w->endDtd();
$w->startElement('order');
$w->writeElement('id', '42');
$w->writeElement('total', '499');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'ping');
xmlwriter_start_dtd_element($w, 'ping');
xmlwriter_text($w, 'EMPTY');
xmlwriter_end_dtd_element($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'ping');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE ping [<!ELEMENT ping EMPTY>]><ping/>

Соседние операции: XMLWriter::endDtdElement(), XMLWriter::writeDtdElement(), XMLWriter::startElement().

• PHP: XMLWriter::startDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endDtdElement(): bool

Завершить открытое объявление ELEMENT в DTD.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool. Не заменяет endElement: тот закрывает узел с данными, а эта операция — правило его структуры.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_dtd_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('order');
$w->startDtdElement('order');
$w->text('(id,');
$w->text('total)');
$w->endDtdElement();
$w->writeDtdElement('id', '(#PCDATA)');
$w->writeDtdElement('total', '(#PCDATA)');
$w->endDtd();
$w->startElement('order');
$w->writeElement('id', '42');
$w->writeElement('total', '499');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'ping');
xmlwriter_start_dtd_element($w, 'ping');
xmlwriter_text($w, 'EMPTY');
xmlwriter_end_dtd_element($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'ping');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE ping [<!ELEMENT ping EMPTY>]><ping/>

Соседние операции: XMLWriter::startDtdElement(), XMLWriter::writeDtdElement(), XMLWriter::endElement().

• PHP: XMLWriter::endDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_dtd_element(XMLWriter $writer): bool

Завершить открытое объявление ELEMENT в DTD.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool. Не заменяет endElement: тот закрывает узел с данными, а эта операция — правило его структуры.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endDtdElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('order');
$w->startDtdElement('order');
$w->text('(id,');
$w->text('total)');
$w->endDtdElement();
$w->writeDtdElement('id', '(#PCDATA)');
$w->writeDtdElement('total', '(#PCDATA)');
$w->endDtd();
$w->startElement('order');
$w->writeElement('id', '42');
$w->writeElement('total', '499');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE order [<!ELEMENT order (id,total)><!ELEMENT id (#PCDATA)><!ELEMENT total (#PCDATA)>]><order><id>42</id><total>499</total></order>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'ping');
xmlwriter_start_dtd_element($w, 'ping');
xmlwriter_text($w, 'EMPTY');
xmlwriter_end_dtd_element($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'ping');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE ping [<!ELEMENT ping EMPTY>]><ping/>

Соседние операции: XMLWriter::startDtdElement(), XMLWriter::writeDtdElement(), XMLWriter::endElement().

• PHP: XMLWriter::endDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeDtdElement(string $name, string $content): bool

Записать полное объявление ELEMENT с готовой моделью содержимого.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_dtd_element(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Sent');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Sent</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'catalog');
xmlwriter_write_dtd_element($w, 'catalog', '(item*)');
xmlwriter_write_dtd_element($w, 'item', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'catalog');
foreach (['A', 'B'] as $sku) {
    xmlwriter_write_element($w, 'item', $sku);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog [<!ELEMENT catalog (item*)><!ELEMENT item (#PCDATA)>]><catalog><item>A</item><item>B</item></catalog>

Соседние операции: XMLWriter::startDtdElement(), XMLWriter::writeDtdAttlist(), XMLWriter::writeElement().

• PHP: XMLWriter::writeDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_dtd_element(XMLWriter $writer, string $name, string $content): bool

Записать полное объявление ELEMENT с готовой моделью содержимого.

DTD — объявления допустимой структуры документа, его атрибутов и сущностей. Их пишут перед корневым элементом. XMLWriter лишь формирует текст DTD: не валидирует последующий документ и не загружает указанную внешнюю DTD. В новой интеграции DTD нужна только по договору получателя; это не обязательная часть любого XML. Для модели содержимого применяют EMPTY, ANY, (#PCDATA), последовательность (id,total), альтернативу (a|b), суффиксы ?/*/+ для необязательности и повторения. Эти символы находятся внутри строки и принадлежат языку DTD. Возвращает bool.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeDtdElement(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('message');
$w->writeDtdElement('message', '(#PCDATA)');
$w->endDtd();
$w->writeElement('message', 'Sent');
echo $w->outputMemory(), "\n";

<!DOCTYPE message [<!ELEMENT message (#PCDATA)>]><message>Sent</message>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'catalog');
xmlwriter_write_dtd_element($w, 'catalog', '(item*)');
xmlwriter_write_dtd_element($w, 'item', '(#PCDATA)');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'catalog');
foreach (['A', 'B'] as $sku) {
    xmlwriter_write_element($w, 'item', $sku);
}
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog [<!ELEMENT catalog (item*)><!ELEMENT item (#PCDATA)>]><catalog><item>A</item><item>B</item></catalog>

Соседние операции: XMLWriter::startDtdElement(), XMLWriter::writeDtdAttlist(), XMLWriter::writeElement().

• PHP: XMLWriter::writeDtdElement
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startDtdAttlist(string $name): bool

Начать объявление ATTLIST, чтобы описать атрибуты элемента.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_dtd_attlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->startDtdAttlist('item');
$w->text('sku CDATA ');
$w->text('#REQUIRED');
$w->endDtdAttlist();
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'price');
xmlwriter_write_dtd_element($w, 'price', '(#PCDATA)');
xmlwriter_start_dtd_attlist($w, 'price');
xmlwriter_text($w, 'currency (RUB|EUR) "RUB"');
xmlwriter_end_dtd_attlist($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'price', '499');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE price [<!ELEMENT price (#PCDATA)><!ATTLIST price currency (RUB|EUR) "RUB">]><price>499</price>

Соседние операции: XMLWriter::endDtdAttlist(), XMLWriter::writeDtdAttlist(), XMLWriter::writeAttribute().

• PHP: XMLWriter::startDtdAttlist
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_dtd_attlist(XMLWriter $writer, string $name): bool

Начать объявление ATTLIST, чтобы описать атрибуты элемента.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startDtdAttlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->startDtdAttlist('item');
$w->text('sku CDATA ');
$w->text('#REQUIRED');
$w->endDtdAttlist();
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'price');
xmlwriter_write_dtd_element($w, 'price', '(#PCDATA)');
xmlwriter_start_dtd_attlist($w, 'price');
xmlwriter_text($w, 'currency (RUB|EUR) "RUB"');
xmlwriter_end_dtd_attlist($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'price', '499');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE price [<!ELEMENT price (#PCDATA)><!ATTLIST price currency (RUB|EUR) "RUB">]><price>499</price>

Соседние операции: XMLWriter::endDtdAttlist(), XMLWriter::writeDtdAttlist(), XMLWriter::writeAttribute().

• PHP: XMLWriter::startDtdAttlist
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endDtdAttlist(): bool

Завершить открытый список объявлений атрибутов DTD.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента. Параметров нет. Для окончания обычного атрибута используется endAttribute, а не этот метод.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_dtd_attlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->startDtdAttlist('item');
$w->text('sku CDATA ');
$w->text('#REQUIRED');
$w->endDtdAttlist();
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'price');
xmlwriter_write_dtd_element($w, 'price', '(#PCDATA)');
xmlwriter_start_dtd_attlist($w, 'price');
xmlwriter_text($w, 'currency (RUB|EUR) "RUB"');
xmlwriter_end_dtd_attlist($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'price', '499');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE price [<!ELEMENT price (#PCDATA)><!ATTLIST price currency (RUB|EUR) "RUB">]><price>499</price>

Соседние операции: XMLWriter::startDtdAttlist(), XMLWriter::writeDtdAttlist(), XMLWriter::endAttribute().

• PHP: XMLWriter::endDtdAttlist
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_dtd_attlist(XMLWriter $writer): bool

Завершить открытый список объявлений атрибутов DTD.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента. Параметров нет. Для окончания обычного атрибута используется endAttribute, а не этот метод.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endDtdAttlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->startDtdAttlist('item');
$w->text('sku CDATA ');
$w->text('#REQUIRED');
$w->endDtdAttlist();
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'price');
xmlwriter_write_dtd_element($w, 'price', '(#PCDATA)');
xmlwriter_start_dtd_attlist($w, 'price');
xmlwriter_text($w, 'currency (RUB|EUR) "RUB"');
xmlwriter_end_dtd_attlist($w);
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'price', '499');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE price [<!ELEMENT price (#PCDATA)><!ATTLIST price currency (RUB|EUR) "RUB">]><price>499</price>

Соседние операции: XMLWriter::startDtdAttlist(), XMLWriter::writeDtdAttlist(), XMLWriter::endAttribute().

• PHP: XMLWriter::endDtdAttlist
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::writeDtdAttlist(string $name, string $content): bool

Записать готовый список правил атрибутов одного элемента.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_dtd_attlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->writeDtdAttlist('item', 'sku CDATA #REQUIRED');
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_write_dtd_element($w, 'item', 'EMPTY');
xmlwriter_write_dtd_attlist($w, 'item', 'sku CDATA #REQUIRED note CDATA #IMPLIED');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'item');
xmlwriter_write_attribute($w, 'sku', 'B');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED note CDATA #IMPLIED>]><item sku="B"/>

Соседние операции: XMLWriter::startDtdAttlist(), XMLWriter::writeDtdElement(), XMLWriter::writeAttribute().

• PHP: XMLWriter::writeDtdAttlist
• PHP 8.5.11: реализация

PHP 5.1.2; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_write_dtd_attlist(XMLWriter $writer, string $name, string $content): bool

Записать готовый список правил атрибутов одного элемента.

Внутри открытой DTD описывает атрибуты указанного элемента. Формат: имя атрибута, тип, правило значения. #REQUIRED — обязателен; #IMPLIED — необязателен без default; строка в кавычках — default; #FIXED со строкой — фиксированное значение. Возвращает bool. Это описание правил, не запись атрибута в экземпляр элемента.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeDtdAttlist(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('item');
$w->writeDtdElement('item', 'EMPTY');
$w->writeDtdAttlist('item', 'sku CDATA #REQUIRED');
$w->endDtd();
$w->startElement('item');
$w->writeAttribute('sku', 'A');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED>]><item sku="A"/>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_write_dtd_element($w, 'item', 'EMPTY');
xmlwriter_write_dtd_attlist($w, 'item', 'sku CDATA #REQUIRED note CDATA #IMPLIED');
xmlwriter_end_dtd($w);
xmlwriter_start_element($w, 'item');
xmlwriter_write_attribute($w, 'sku', 'B');
xmlwriter_end_element($w);
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ELEMENT item EMPTY><!ATTLIST item sku CDATA #REQUIRED note CDATA #IMPLIED>]><item sku="B"/>

Соседние операции: XMLWriter::startDtdAttlist(), XMLWriter::writeDtdElement(), XMLWriter::writeAttribute().

• PHP: XMLWriter::writeDtdAttlist
• PHP 8.5.11: реализация

PHP 5.2.1; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::startDtdEntity(string $name, bool $isParam): bool

Начать объявление сущности DTD: обычной строки либо параметрической части DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_start_dtd_entity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->startDtdEntity('shop', false);
$w->text('Example Shop');
$w->endDtdEntity();
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_start_dtd_entity($w, 'itemModel', true);
xmlwriter_text($w, '<!ELEMENT item EMPTY>');
xmlwriter_end_dtd_entity($w);
xmlwriter_write_raw($w, '%itemModel;');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'item');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ENTITY % itemModel "<!ELEMENT item EMPTY>">%itemModel;]><item/>

Соседние операции: XMLWriter::endDtdEntity(), XMLWriter::writeDtdEntity(), XMLWriter::writeRaw().

• PHP: XMLWriter::startDtdEntity
• PHP 8.5.11: реализация

PHP 5.2.1; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_start_dtd_entity(XMLWriter $writer, string $name, bool $isParam): bool

Начать объявление сущности DTD: обычной строки либо параметрической части DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::startDtdEntity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->startDtdEntity('shop', false);
$w->text('Example Shop');
$w->endDtdEntity();
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_start_dtd_entity($w, 'itemModel', true);
xmlwriter_text($w, '<!ELEMENT item EMPTY>');
xmlwriter_end_dtd_entity($w);
xmlwriter_write_raw($w, '%itemModel;');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'item');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ENTITY % itemModel "<!ELEMENT item EMPTY>">%itemModel;]><item/>

Соседние операции: XMLWriter::endDtdEntity(), XMLWriter::writeDtdEntity(), XMLWriter::writeRaw().

• PHP: XMLWriter::startDtdEntity
• PHP 8.5.11: реализация

PHP 5.2.1; примеры PHP 8.2+ · xmlwriter / libxml

XMLWriter::endDtdEntity(): bool

Закончить текущее объявление сущности DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку. Метод не принимает имя и не завершает всю DTD.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_end_dtd_entity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->startDtdEntity('shop', false);
$w->text('Example Shop');
$w->endDtdEntity();
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_start_dtd_entity($w, 'itemModel', true);
xmlwriter_text($w, '<!ELEMENT item EMPTY>');
xmlwriter_end_dtd_entity($w);
xmlwriter_write_raw($w, '%itemModel;');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'item');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ENTITY % itemModel "<!ELEMENT item EMPTY>">%itemModel;]><item/>

Соседние операции: XMLWriter::startDtdEntity(), XMLWriter::writeDtdEntity(), XMLWriter::endDtd().

• PHP: XMLWriter::endDtdEntity
• PHP 8.5.11: реализация

PHP 5.2.1; примеры PHP 8.2+ · xmlwriter / libxml

xmlwriter_end_dtd_entity(XMLWriter $writer): bool

Закончить текущее объявление сущности DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку. Метод не принимает имя и не завершает всю DTD.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::endDtdEntity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->startDtdEntity('shop', false);
$w->text('Example Shop');
$w->endDtdEntity();
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'item');
xmlwriter_start_dtd_entity($w, 'itemModel', true);
xmlwriter_text($w, '<!ELEMENT item EMPTY>');
xmlwriter_end_dtd_entity($w);
xmlwriter_write_raw($w, '%itemModel;');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'item');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE item [<!ENTITY % itemModel "<!ELEMENT item EMPTY>">%itemModel;]><item/>

Соседние операции: XMLWriter::startDtdEntity(), XMLWriter::writeDtdEntity(), XMLWriter::endDtd().

• PHP: XMLWriter::endDtdEntity
• PHP 8.5.11: реализация

PHP 5.2.1; nullable identifiers PHP 8.0+ · xmlwriter / libxml

XMLWriter::writeDtdEntity(string $name, string $content, bool $isParam = false, ?string $publicId = null, ?string $systemId = null, ?string $notationData = null): bool

Записать полное объявление внутренней или внешней сущности DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку. publicId/systemId/notationData официально nullable с PHP 8.0. В XMLWriter нет отдельного метода объявления NOTATION: если формат требует NDATA, её доверенное объявление включают в DTD отдельно; это продвинутый контракт, не произвольная строка в параметре.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: xmlwriter_write_dtd_entity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->writeDtdEntity('shop', 'Example Shop');
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'catalog');
xmlwriter_write_dtd_element($w, 'catalog', 'EMPTY');
xmlwriter_write_dtd_entity($w, 'legal', '', false, null, 'legal.txt');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'catalog');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog [<!ELEMENT catalog EMPTY><!ENTITY legal SYSTEM "legal.txt">]><catalog/>

Соседние операции: XMLWriter::startDtdEntity(), XMLWriter::writeDtd(), XMLWriter::writeRaw().

• PHP: XMLWriter::writeDtdEntity
• PHP 8.5.11: реализация

PHP 5.2.1; nullable identifiers PHP 8.0+ · xmlwriter / libxml

xmlwriter_write_dtd_entity(XMLWriter $writer, string $name, string $content, bool $isParam = false, ?string $publicId = null, ?string $systemId = null, ?string $notationData = null): bool

Записать полное объявление внутренней или внешней сущности DTD.

Возвращает bool. Обычная сущность используется через &имя; в документе; параметрическая — через %имя; внутри DTD. Нельзя передавать внешним данным управление декларациями/URI: это отдельная граница доверия для будущего XML-парсера. XMLWriter не разворачивает сущности и не выполняет их загрузку. publicId/systemId/notationData официально nullable с PHP 8.0. В XMLWriter нет отдельного метода объявления NOTATION: если формат требует NDATA, её доверенное объявление включают в DTD отдельно; это продвинутый контракт, не произвольная строка в параметре.

Обычные операции записи возвращают true при успехе и false при отказе, например если атрибут пытаются добавить после текста. Неподготовленный объект вызывает Error; неверный тип аргумента — TypeError, некорректное имя в проверяемых операциях PHP 8 — ValueError. Успех записи не означает проверку всего документа по XML Schema/DTD. Небольшие примеры показывают порядок вызовов с известными корректными данными; в разделе надёжная выгрузка проверяется результат каждого шага.

Другая форма вызова с тем же смыслом: XMLWriter::writeDtdEntity(). В примерах ниже показаны обе формы; открытие буфера — исключение: метод возвращает bool, процедурная функция возвращает объект или false.

<?php
$w = new XMLWriter();
if (!$w->openMemory()) {
    throw new RuntimeException('Не удалось открыть буфер');
}
$w->startDtd('brand');
$w->writeDtdElement('brand', '(#PCDATA)');
$w->writeDtdEntity('shop', 'Example Shop');
$w->endDtd();
$w->startElement('brand');
$w->writeRaw('&shop;');
$w->endElement();
echo $w->outputMemory(), "\n";

<!DOCTYPE brand [<!ELEMENT brand (#PCDATA)><!ENTITY shop "Example Shop">]><brand>&shop;</brand>

<?php
$w = xmlwriter_open_memory();
if ($w === false) {
    throw new RuntimeException('Не удалось открыть буфер');
}
xmlwriter_start_dtd($w, 'catalog');
xmlwriter_write_dtd_element($w, 'catalog', 'EMPTY');
xmlwriter_write_dtd_entity($w, 'legal', '', false, null, 'legal.txt');
xmlwriter_end_dtd($w);
xmlwriter_write_element($w, 'catalog');
echo xmlwriter_output_memory($w), "
";

<!DOCTYPE catalog [<!ELEMENT catalog EMPTY><!ENTITY legal SYSTEM "legal.txt">]><catalog/>

Соседние операции: XMLWriter::startDtdEntity(), XMLWriter::writeDtd(), XMLWriter::writeRaw().

• PHP: XMLWriter::writeDtdEntity
• PHP 8.5.11: реализация