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

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

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

基本的な使い方

nodeValueプロパティは、DOMAttrクラスのインスタンスが表すHTMLやXML文書内の要素が持つ属性の値を保持するプロパティです。DOMAttrクラスは、例えば<div id="main">のようなHTML要素においてid="main"全体を表現し、このnodeValueプロパティはその属性の「値」、つまり"main"という文字列にアクセスするために使用されます。

このプロパティを利用することで、属性の現在の値を取得したり、新しい値を設定して属性を変更したりできます。例えば、ウェブページを動的に操作する際に、特定のHTML要素のid属性、class属性、または画像のsrc属性などの値をPHPコードから読み取ったり、新しい値に書き換えたりする際に非常に役立ちます。

nodeValueプロパティは読み書きが可能で、常に文字列型として属性値を扱います。また、同じDOMAttrクラスにはvalueというプロパティも存在し、このnodeValueプロパティと全く同じ機能を提供します。したがって、どちらを使用しても属性の値にアクセスし、操作することができます。システムエンジニアを目指す方々がウェブアプリケーション開発やXMLデータ処理において、DOM構造をプログラムから操作する際の基本的な要素として理解しておくことが重要です。

構文(syntax)


1<?php
2// DOMAttr オブジェクトを準備します。ここではDOMDocumentを使って属性を作成し、取得する例を示します。
3$dom = new DOMDocument();
4$element = $dom->createElement('item');
5$attribute = $dom->createAttribute('data-id');
6$attribute->value = '123'; // 属性の初期値を設定
7$element->appendChild($attribute);
8$dom->appendChild($element);
9
10// DOMAttr オブジェクトを取得します。
11$attrNode = $element->attributes->getNamedItem('data-id');
12
13// DOMAttr::nodeValue プロパティの値を参照する構文
14echo $attrNode->nodeValue; // 出力: 123
15
16// DOMAttr::nodeValue プロパティに新しい値を設定する構文
17$attrNode->nodeValue = '456';
18echo $attrNode->nodeValue; // 出力: 456
19?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMAttr オブジェクトの属性値を文字列として返します。

サンプルコード

PHP DOMAttr nodeValue で属性値を取得する


1<?php
2
3// HTML ドキュメントを読み込む
4$dom = new DOMDocument();
5$dom->loadHTML('<!DOCTYPE html><html><body><p id="myAttr" data-value="Hello World!">Paragraph</p></body></html>');
6
7// 属性ノードを取得する
8$element = $dom->getElementById('myAttr');
9$attribute = $element->getAttributeNode('data-value');
10
11// 属性ノードの値を取得する
12if ($attribute) {
13    $attributeValue = $attribute->nodeValue;
14
15    // 属性ノードの値を出力する
16    echo "Attribute Value: " . $attributeValue . PHP_EOL;
17} else {
18    echo "Attribute not found." . PHP_EOL;
19}
20
21?>

PHPのDOMAttrクラスにおけるnodeValueプロパティは、属性ノードの値を文字列として取得するために使用されます。このプロパティには引数はなく、戻り値として属性ノードの値を表す文字列を返します。

上記のサンプルコードでは、まずDOMDocumentクラスを使用してHTMLドキュメントを読み込んでいます。次に、getElementByIdメソッドでid属性が"myAttr"である要素を取得し、その要素からgetAttributeNodeメソッドでdata-value属性のノードを取得しています。

取得した属性ノードが存在するかどうかをif文で確認し、存在する場合、$attribute->nodeValueによって属性ノードの値を文字列として取得しています。そして、取得した属性値をecho文で出力しています。もし属性ノードが見つからない場合は、「Attribute not found.」というメッセージを出力します。

この例では、data-value属性の値である"Hello World!"がnodeValueプロパティによって取得され、画面に出力されます。nodeValueプロパティは、属性ノードが持つテキストコンテンツにアクセスするための重要な手段です。HTML要素の属性値を動的に取得し、処理を行う際に役立ちます。

DOMAttr::nodeValueは、属性ノードの値を文字列として取得します。このサンプルコードでは、data-value属性の値を取得しています。loadHTMLでHTMLを読み込む際、文字エンコーディングに注意してください。特に日本語を含む場合は、適切なエンコーディングを指定しないと文字化けする可能性があります。getAttributeNodeは、属性が存在しない場合にnullを返すため、必ず存在チェックを行いましょう。また、属性値がHTMLエンティティ（例：&）を含む場合、nodeValueは自動的にデコードしません。必要に応じてhtmlspecialchars_decode関数を使用してデコードしてください。