DOMDocument::createProcessingInstruction

(PHP 5, PHP 7, PHP 8)

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

Описание

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

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

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

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

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

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

Ошибки

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() - Создать новый текстовый узел

add a note

User Contributed Notes 1 note

down

romain at supinfo dot com ¶

15 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>

add a note