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

isConnectedプロパティは、その処理命令ノードがドキュメントツリーに接続されているかどうかを示す真偽値（bool）を保持するプロパティです。このプロパティの値がtrueである場合、そのノードはDom\Documentオブジェクトに直接的または間接的に接続されており、現在ドキュメントの一部であることを意味します。例えば、appendChildメソッドなどを用いてドキュメントに追加されたノードのisConnectedはtrueになります。一方、値がfalseである場合は、そのノードがドキュメントツリーから切り離されている状態を示します。これは、new Dom\ProcessingInstruction()で新しく作成された直後でまだドキュメントに追加されていない状態や、removeChildメソッドによってドキュメントから削除された後の状態などが該当します。このプロパティは読み取り専用であり、現在の接続状態を確認するために使用します。開発者がこのプロパティに値を代入して、ノードの接続状態を直接変更することはできません。DOM操作を行う際に、対象のノードがドキュメント内に実際に存在するかどうかを安全に確認する目的で利用されます。

Copy
1<?php
2
3// DOMドキュメントと処理命令ノードを作成します
4$document = new Dom\Document();
5$pi = $document->createProcessingInstruction('php', 'echo "Hello";');
6
7// ノードがドキュメントに接続される前の状態を確認します
8var_dump($pi->isConnected); // false
9
10// ノードをドキュメントに追加して接続します
11$document->appendChild($pi);
12
13// ノードがドキュメントに接続された後の状態を確認します
14var_dump($pi->isConnected); // true
15
16?>

引数なし

引数はありません

bool

このプロパティは、Dom\ProcessingInstruction オブジェクトがツリーに接続されているかどうかを示す真偽値（true または false）を返します。