【PHP8.x】DOMProcessingInstruction::isConnectedプロパティの使い方

『isConnectedプロパティは、DOMProcessingInstructionオブジェクトがドキュメントツリーに接続されているかどうかを示す真偽値（bool）を保持するプロパティです。このプロパティの値が true となるのは、その処理命令ノードが DOMDocument オブジェクトの一部として、実際にドキュメント内に配置されている場合です。例えば、appendChild() や insertBefore() などのメソッドを使ってドキュメントに追加されたノードは、接続された状態と見なされます。反対に、new DOMProcessingInstruction() でインスタンスを作成した直後や、removeChild() メソッドによってドキュメントから削除されたノードは、どのドキュメントにも属していないため、このプロパティは false を返します。このプロパティを参照することで、特定の処理命令が現在ドキュメントの有効な構成要素であるかを簡単に確認できます。なお、このプロパティは読み取り専用のため、開発者が直接値を変更することはできず、ノードの状態に応じて自動的に値が更新されます。

Copy
1<?php
2
3$doc = new DOMDocument();
4$pi = $doc->createProcessingInstruction('php-version', '"8"');
5
6// ノードがドキュメントに追加される前は false
7var_dump($pi->isConnected);
8
9// ノードをドキュメントに追加する
10$doc->appendChild($pi);
11
12// ノードがドキュメントに追加された後は true
13var_dump($pi->isConnected);
14
15?>

引数なし

引数はありません

bool

このプロパティは、DOMProcessingInstructionノードがドキュメントツリーに接続されているかどうかを示す真偽値を返します。