DOMDocument::createProcessingInstruction

(PHP 5, PHP 7, PHP 8)

DOMDocument::createProcessingInstruction — Создать новый PI-узел

Описание

public function DOMDocument::createProcessingInstruction(string $target, string $data = ""): DOMProcessingInstruction |false

Эта функция создаёт экземпляр класса DOMProcessingInstruction . Узел не будет отображаться в документе до тех пор, пока его не вставят функцией наподобие DOMNode::appendChild() .

Список параметров

target: Цель инструкции для обработчика документа.
data: Содержимое инструкции обработчика.

Возвращаемые значения

Новый объект класса DOMProcessingInstruction либо false в случае возникновения ошибки.

Ошибки

Может выбросить исключение DOMException со следующими кодами ошибок:

DOM_INVALID_CHARACTER_ERR: Возникает, если target содержит недопустимы символы.

Смотрите также

DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
DOMDocument::createAttribute() - Создаёт новый атрибут
DOMDocument::createAttributeNS() - Создаёт новый атрибут узла с соответствующим пространством имён
DOMDocument::createCDATASection() - Создаёт новый узел cdata
DOMDocument::createComment() - Создать новый узел комментария
DOMDocument::createDocumentFragment() - Создаёт новый фрагмент документа
DOMDocument::createElement() - Создаёт новый узел элемента
DOMDocument::createElementNS() - Создать новый узел элемента с соответствующим пространством имён
DOMDocument::createEntityReference() - Создать новый узел ссылки на сущность
DOMDocument::createTextNode() - Создать новый текстовый узел

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей 1 note

down

romain at supinfo dot com ¶

17 years ago

A use exemple of this method :
Usefull for generating an XML linked with a XSLT !
<?php
// "Create" the document.
$xml = new DOMDocument( "1.0", "ISO-8859-15" );
//to have indented output, not just a line
$xml->preserveWhiteSpace = false;
$xml->formatOutput = true;
// ------------- Interresting part here ------------
//creating an xslt adding processing line
$xslt = $xml->createProcessingInstruction('xml-stylesheet', 'type="text/xsl" href="base.xsl"');
//adding it to the xml
$xml->appendChild($xslt);
// ----------- / Interresting part here -------------
//adding some elements
$root = $xml->createElement("list");
$node = $xml->createElement("contact", "John Doe");
$root-> appendChild($node);
$xml-> appendChild($root);
//creating the file
$xml-> save("output.xml");
?>

output.xml :
<?xml version="1.0" encoding="ISO-8859-15"?>
<?xml-stylesheet type="text/xsl" href="base.xsl"?> //the line has been created successfully
<list>
 <contact>John Doe</contact>
</list>

+Добавить