【PHP8.x】DOMAttr::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 DOMDocument nodeValue で属性値を取得する


1<?php
2
3/**
4 * XMLから特定の属性の値を抽出し、表示するサンプルコード。
5 * DOMAttr::nodeValueプロパティの使用方法を示します。
6 * システムエンジニアを目指す初心者向けに、DOMDocumentを使ったXML操作の基本を解説します。
7 */
8
9// 1. DOMDocumentオブジェクトを新しく作成します。
10//    このオブジェクトはXMLやHTMLドキュメントを表現し、操作するための中心となります。
11$dom = new DOMDocument();
12
13// 2. 解析するXML文字列を定義します。
14//    ここでは、`item`要素が`id`と`name`という2つの属性を持つシンプルなXMLを使用します。
15$xmlString = '<root><item id="product-101" name="Smartphone X">This is a product description.</item></root>';
16
17// 3. 定義したXML文字列をDOMDocumentオブジェクトにロードします。
18//    `loadXML()`メソッドは、文字列からXMLを解析し、DOMツリーを構築します。
19//    エラーが発生した場合はfalseを返します。
20if (!$dom->loadXML($xmlString)) {
21    echo "XMLのロードに失敗しました。" . PHP_EOL;
22    exit(1);
23}
24
25// 4. ドキュメント内で特定のタグ名（ここでは'item'）を持つすべての要素を取得します。
26//    `getElementsByTagName()`はDOMNodeListオブジェクトを返します。
27$items = $dom->getElementsByTagName('item');
28
29// 5. 取得した要素リストに一つでも要素が存在するかを確認します。
30if ($items->length > 0) {
31    // 6. 最初の'item'要素を取得します。
32    //    `item(0)`でリストの最初の要素にアクセスできます。
33    $itemElement = $items->item(0);
34
35    // 7. 取得した要素から特定の属性（ここでは'id'）を探します。
36    //    `attributes`プロパティはDOMNamedNodeMapを返し、要素のすべての属性を含みます。
37    //    `getNamedItem('id')`メソッドで、'id'という名前の属性ノード（DOMAttrオブジェクト）を取得します。
38    $idAttribute = $itemElement->attributes->getNamedItem('id');
39
40    // 8. 'id'属性ノードが取得できたかを確認します。
41    //    `instanceof DOMAttr`で、実際にDOMAttrオブジェクトであることを確認できます。
42    if ($idAttribute instanceof DOMAttr) {
43        // 9. DOMAttr::nodeValueプロパティにアクセスして、属性の実際の値を取得します。
44        //    このプロパティは、ノードの値（属性の場合はその文字列値）を返します。
45        $attributeValue = $idAttribute->nodeValue;
46
47        // 10. 取得した属性値を表示します。
48        echo "取得した 'id' 属性の値: " . $attributeValue . PHP_EOL; // 出力: 取得した 'id' 属性の値: product-101
49    } else {
50        echo "要素に 'id' 属性が見つかりませんでした。" . PHP_EOL;
51    }
52} else {
53    echo "'item' 要素が見つかりませんでした。" . PHP_EOL;
54}
55
56?>

このサンプルコードは、PHPのDOM（Document Object Model）拡張機能を用いて、XMLドキュメントから特定の属性の値を効率的に抽出する方法を、システムエンジニアを目指す初心者向けに解説しています。

まず、DOMDocumentオブジェクトを作成し、対象となるXML文字列をloadXML()メソッドで読み込むことで、XMLをプログラムで操作できるツリー構造に変換します。次に、getElementsByTagName()メソッドを使って、ドキュメント中から特定のタグ名（この例では'item'）を持つ要素をすべて取得します。

取得した要素の中から目的の要素を選び、そのattributesプロパティから、要素に紐づく属性のリストにアクセスします。さらに、getNamedItem('id')メソッドで、特定の名前（ここでは'id'）を持つ属性ノード（DOMAttrオブジェクト）を取得します。

このDOMAttrオブジェクトが持つnodeValueプロパティは、属性の実際の文字列値を取得するために使用されます。このプロパティは引数を取らず、属性の値を文字列（string）として直接返します。例えば、XMLのid="product-101"という属性から「product-101」という値を取り出すことが可能です。このようにして取得した属性値は、最終的に画面に表示され、XMLデータの抽出プロセスが完了します。

DOMAttr::nodeValueは、DOMAttrオブジェクトから属性の文字列値を取得する際に利用するプロパティです。XMLを操作する際は、ドキュメントのロードや目的の要素・属性の取得が常に成功するとは限らないため、エラーハンドリングを丁寧に行うことが非常に重要です。特に、getNamedItemの結果が属性ノードであるかを確認するためにinstanceof DOMAttrで型チェックを行うと、プログラムの予期せぬ終了を防ぎ、より堅牢なコードになります。nodeValueは属性値だけでなく、テキストノードなどの値も取得できる汎用的なプロパティであることも覚えておきましょう。XMLの構造を理解し、適切なエラー処理を実装することが、安全で信頼性の高いシステムを構築する上で不可欠です。

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関数を使用してデコードしてください。