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

isConnectedプロパティは、PHPのDOM拡張機能で使用されるDOMTextオブジェクトが、現在DOMツリー（HTMLやXML文書の階層構造）内に接続されているかどうかを示すブール値（真偽値）を保持するプロパティです。

このプロパティは、DOMTextオブジェクトがDOMDocumentインスタンスの子孫ノードとして、実際に文書構造の一部になっている場合にtrueを返します。例えば、DOMDocumentのappendChildメソッドやinsertBeforeメソッドなどを使って、テキストノードが文書に追加された後にこのプロパティを参照するとtrueとなります。

対照的に、new DOMText()のように単独で生成されたばかりで、まだどの文書にも追加されていないテキストノードや、一度文書に追加されたものの、removeChildメソッドなどによって文書から削除されたテキストノードはfalseを返します。

isConnectedプロパティを利用することで、特定のテキストノードが現在DOMツリー内で有効な状態にあるかを簡単に確認できます。これは、ノードに対して特定の操作を行う前に、そのノードが現在文書の一部であるかを検証したり、ノードの状態に応じて処理を条件分岐させたりする際に非常に有用です。DOMTextオブジェクトはDOMNodeを継承しているため、このプロパティを利用可能です。

Copy
1<?php
2$document = new DOMDocument();
3$textNode = $document->createTextNode("Example Text");
4
5// DOMText::isConnected プロパティにアクセスする構文
6$isConnected = $textNode->isConnected;
7?>

引数なし

引数はありません

bool

DOMTextノードがDOMツリーに接続されているかどうかを示します。接続されている場合はtrue、そうでない場合はfalseを返します。