DOMDocument::createEntityReference

(PHP 5, PHP 7, PHP 8)

DOMDocument::createEntityReference — Create new entity reference node

Descripción

public DOMDocument::createEntityReference(string $name): DOMEntityReference|false

Esta función crea una nueva instancia de la clase DOMEntityReference. Este nodo no se mostrará en el documento a no ser que sea insertado con (p.e.j.) DOMNode::appendChild().

Parámetros

name: El contenido de la entidad referencia, p.ej. la entidad referencia menos los carácteres & inicial y el ; final.

Valores devueltos

El nuevo DOMEntityReference o false si ha ocurrido un error.

Errores/Excepciones

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

Ver también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMDocument::createAttribute() - Crear nuevo attribute
DOMDocument::createAttributeNS() - Crea un nuevo nodo atributo con un namespace 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::createProcessingInstruction() - Crea un nuevo nodo PI
DOMDocument::createTextNode() - Crea un nuevo nodo de texto

Improve This Page

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

＋add a note

User Contributed Notes 2 notes

down

alicewonder at shastaherps dot org ¶

9 years ago

It appears that this does not work with numbered entities, only named entities.

$nbspace = $dom->createEntityReference('nbsp');

works

$nbspace = $dom->createEntityReference('#160');

does not. This makes this function rather useless when generating an XSL unless you modify the XSL doctype to include the named entity for the character you want.

down

Tuhin Bepari ¶

11 years ago

<?php
/*Entity is a group of words which print a special symbol.
Like if we want to show copy right symbol in html page then we use &copy; code and browser convert this to actual copyright symbol.
There have lots of entity, you can find them all form http://dev.w3.org/html5/html-author/charref 
if you want to use < or > or both <> into a node value than xml will give and warning or make this value as a node.
So tell the xml parser that < or > is not tag symbol it is a entity.To do that you have to right &lt(<) and &gt;(>) instead of < and > symbol.

Entity references always begin with an ampersand (&) and end with a semicolon (;).
DO not need to use & and ; symbol begin and end of entity.Remove it when you want to use it to DOMDocument::createEntityReference
Then append to to a tag where you want to show this symbol.Like below
*/
$dom=new DOMDocument("1.0","UTF-8");
$example=$dom->createElement("example","This is copyright ");
$entity=$dom->createEntityReference("copy");
$example->appendChild($entity);
$dom->appendChild($example);
echo $dom->saveXML();

output is 
This is copyright ©

＋add a note