【PHP8.x】DOMDocument::createTextNode()メソッドの使い方

createTextNodeメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月05日

基本的な使い方

createTextNodeメソッドは、DOMDocumentクラスに所属するメソッドであり、新しいテキストノードを作成するために使用します。このメソッドは、指定されたテキストデータを持つDOMTextオブジェクトを生成し、DOMツリーに追加できる状態にします。

具体的には、DOMDocumentオブジェクトに対してcreateTextNode()メソッドを呼び出し、引数としてテキストデータ（文字列）を渡します。メソッドは、このテキストデータを持つDOMTextノードを生成し、そのノードへの参照を返します。

このメソッドは、ウェブページの動的なコンテンツ生成や、XMLドキュメントの操作において非常に重要です。例えば、データベースから取得したデータをウェブページに表示する際、createTextNode()メソッドを使用してテキストノードを作成し、DOMツリーに追加することで、動的にコンテンツを生成できます。

生成されたDOMTextノードは、appendChild()などのメソッドを使用して、既存のDOM要素の子ノードとして追加できます。また、nodeValueプロパティを通じて、後からテキストノードの値を変更することも可能です。

createTextNode()メソッドは、テキストデータを安全にDOMツリーに追加するために、テキストデータ内の特殊文字（例えば、&, <, >など）を適切なエンティティ参照（例えば、&, <, >など）に自動的にエスケープします。これにより、クロスサイトスクリプティング（XSS）などのセキュリティリスクを軽減することができます。

システムエンジニアは、このメソッドを理解し、適切に使用することで、PHPを使用して動的なウェブコンテンツやXMLドキュメントを効率的に操作できるようになります。特に、データベース連携やAPI連携を行うシステム開発においては、データの整形とDOM操作が不可欠であり、createTextNode()メソッドはその中心的な役割を担います。

構文(syntax)


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

引数(parameters)

string $data

string $data: 新しく作成するテキストノードの内容となる文字列

戻り値(return)

DOMText

DOMTextオブジェクトを返します。これは、XMLまたはHTMLドキュメント内に挿入できるテキストノードを表します。

サンプルコード

PHP DOMDocumentでテキストノードを作成する


1<?php
2
3// DOMDocumentを新規作成
4$dom = new DOMDocument('1.0', 'UTF-8');
5
6// ルート要素を作成
7$root = $dom->createElement('root');
8$dom->appendChild($root);
9
10// テキストノードを作成
11$text = $dom->createTextNode('Hello, World!');
12
13// ルート要素にテキストノードを追加
14$root->appendChild($text);
15
16// XMLドキュメントを表示
17echo $dom->saveXML();
18
19?>

このPHPのサンプルコードは、DOMDocumentクラスのcreateTextNodeメソッドを使用して、XMLドキュメント内にテキストノードを作成し、追加する方法を示しています。

まず、DOMDocumentクラスのインスタンスを生成し、XMLドキュメントのバージョンとエンコーディングを指定します。次に、createElementメソッドでルート要素を作成し、appendChildメソッドでドキュメントに追加します。

createTextNodeメソッドは、引数$dataに指定された文字列を内容とするDOMTextオブジェクト（テキストノード）を生成します。この例では、'Hello, World!'という文字列をテキストノードとして作成しています。引数$dataには、テキストノードに含める文字列を指定します。

作成されたテキストノードは、appendChildメソッドを使用して、ルート要素の子ノードとして追加されます。

最後に、saveXMLメソッドを呼び出すことで、DOMドキュメント全体をXML形式の文字列として取得し、echoで出力しています。これにより、作成されたXMLドキュメントの内容が画面に表示されます。このサンプルコードを実行すると、"<root>Hello, World!</root>"というXMLが出力されます。createTextNodeメソッドは、XMLドキュメントにテキストコンテンツを安全に追加するための重要な機能です。

DOMDocument::createTextNodeメソッドは、テキストノードを生成する際に使用します。引数$dataには、テキストノードに含める文字列を指定します。この文字列はXMLとして適切にエンコードされる必要があります。例えば、<や>などの特殊文字は、<や>のようにエスケープ処理される必要がある点に注意してください。また、生成されたDOMTextオブジェクトは、appendChildなどのメソッドを用いてDOMツリーに追加する必要があります。createTextNodeメソッドだけではXMLドキュメントには反映されないため、注意が必要です。