PHP 8.4.2 Released!

DOMDocument::getElementById »

« DOMDocument::createProcessingInstruction

DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNode — Create new text node

Description

public DOMDocument::createTextNode(string $data): DOMText

This function creates a new instance of class DOMText. This node will not show up in the document unless it is inserted with (e.g.) DOMNode::appendChild().

Parameters

data: The content of the text.

Return Values

The new DOMText.

Changelog

Version	Description
8.1.0	In case of an error, a DomException is thrown now. Previously, `false` was returned.

See Also

DOMNode::appendChild() - Adds new child at the end of the children
DOMDocument::createAttribute() - Create new attribute
DOMDocument::createAttributeNS() - Create new attribute node with an associated namespace
DOMDocument::createCDATASection() - Create new cdata node
DOMDocument::createComment() - Create new comment node
DOMDocument::createDocumentFragment() - Create new document fragment
DOMDocument::createElement() - Create new element node
DOMDocument::createElementNS() - Create new element node with an associated namespace
DOMDocument::createEntityReference() - Create new entity reference node
DOMDocument::createProcessingInstruction() - Creates new PI node

Found A Problem?

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

User Contributed Notes 2 notes

up

down

14

drewish at katherinehouse dot com ¶

10 years ago

The docs don't mention it but this method performs escaping on the value. If you don't want that use createElement() instead.

up

down

0

Alex Kaye ¶

15 years ago

A quick note to anyone who is using character entities (e.g. &copy;) in this, and finding them automatically escaped. The correct thing to do here is to use the createEntityReference method (e.g. createEntityReference("copy");), and then appendChild this entity between text nodes.



Example:



<?php

$copyright_text_1 = $this->document->createTextNode("Copyright ");

$copyright_text_2 = $this->document->createTextNode(" Alex Kaye 2009");

$copyright_symbol = $this->document->createEntityReference("copy");

$copyright->appendChild($copyright_text_1);

$copyright->appendChild($copyright_symbol);

$copyright->appendChild($copyright_text_2);

?>