DOMDocument::createProcessingInstruction

(PHP 5, PHP 7, PHP 8)

DOMDocument::createProcessingInstruction — Crea un nuevo nodo PI

Descripción

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

Esta función crea una nueva instancia de la clase DOMProcessingInstruction . Este nodo no será mostrado en el documento, a menos que sea insertado con DOMNode::appendChild() .

Parámetros

target: El objetivo de la instrucción de procesamiento.
data: El contenido de la instrucción de procesamiento.

Valores devueltos

El nuevo DOMProcessingInstruction o false si ha ocurrido un error.

Errores/Excepciones

Puede lanzar una DOMException con los siguientes códigos de error:

DOM_INVALID_CHARACTER_ERR: Lanzado si target contiene un carácter inválido.

Véase también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMDocument::createAttribute() - Crea un nuevo atributo
DOMDocument::createAttributeNS() - Crea un nuevo atributo con un espacio de nombres asociado
DOMDocument::createCDATASection() - Crea un nuevo nodo cdata
DOMDocument::createComment() - Crea un nuevo nodo de comentario
DOMDocument::createDocumentFragment() - Crea un nuevo fragmento de documento
DOMDocument::createElement() - Crea un nuevo nodo elemento
DOMDocument::createElementNS() - Crea un nuevo nodo elemento con el nombre de espacio asociado
DOMDocument::createEntityReference() - Create new entity reference node
DOMDocument::createTextNode() - Crea un nuevo nodo de texto

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 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>

+add a note