【PHP8.x】dataプロパティの使い方

dataプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

dataプロパティは、DOMCharacterDataクラスに属するプロパティで、XMLやHTMLドキュメントの文字データを保持します。このプロパティは、DOMText(テキストノード)、DOMComment(コメントノード)、DOMCDataSection(CDATAセクションノード)といった、文字情報を直接格納するノードタイプが共通して持つ基底クラスであるDOMCharacterDataのインスタンスで利用できます。具体的には、これらのノードが実際に保持するテキストコンテンツ、つまり文字列データを直接扱います。

このdataプロパティを使用すると、ノードに格納されている文字データを容易に読み取ることが可能です。例えば、ドキュメント内の段落のテキスト内容やコメントの内容を取得したい場合にこのプロパティを参照します。さらに、新しい文字列をdataプロパティに代入することで、ノードの文字データを更新することもできます。この変更は、DOMツリー内のノードコンテンツに即座に反映され、最終的にドキュメントの内容が変更されます。

PHPのDOM拡張機能を利用してWebページのコンテンツを動的に操作したり、XMLデータを解析・生成したりする際に、DOMCharacterData::dataプロパティは、ノードの具体的な文字情報へアクセスし、それを操作するための基本的ながら非常に重要な手段となります。システムエンジニアを目指す方にとって、ドキュメントの構造だけでなく、その中に含まれる詳細な文字内容を正確に扱えるようになるために、このプロパティの理解は不可欠です。

構文(syntax)

1<?php
2$dom = new DOMDocument();
3$textNode = $dom->createTextNode('Original data');
4$textNode->data = 'Modified data';
5echo $textNode->data;
6?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMCharacterData::data プロパティは、ノードのテキスト内容を表す文字列を返します。

【PHP8.x】dataプロパティの使い方 | いっしー@Webエンジニア