【PHP8.x】DOMEntityReference::parentElementプロパティの使い方

parentElementプロパティは、現在のエンティティ参照ノード（DOMEntityReference）の親要素をDOMElementオブジェクトとして保持するプロパティです。このプロパティは読み取り専用であり、直接値を代入して変更することはできません。DOMツリー構造において、現在のノードに親ノードが存在し、かつその親ノードが要素ノード（DOMElement）である場合に、その親要素を表すDOMElementオブジェクトを返します。一方で、親ノードが存在しない場合や、親ノードがドキュメントノード（DOMDocument）などの要素以外のノードである場合には、このプロパティはnullを返します。類似のparentNodeプロパティが親ノードの種類を問わずにDOMNodeオブジェクトを返すのに対し、parentElementは親が要素である場合に限定されるため、特定の要素の子ノードを操作する際に、より厳密で直感的なコードを記述するのに役立ちます。

Copy
1<?php
2
3$xml = <<<XML
4<?xml version="1.0" encoding="UTF-8"?>
5<!DOCTYPE root [
6<!ENTITY myentity "some text">
7]>
8<root>
9  <p>Here is an entity reference: &myentity;</p>
10</root>
11XML;
12
13$dom = new DOMDocument();
14$dom->loadXML($xml);
15
16// p要素内のエンティティ参照ノード (&myentity;) を取得します
17$entityRef = $dom->getElementsByTagName('p')->item(0)->childNodes->item(1);
18
19// DOMEntityReference::parentElement プロパティで親要素を取得します
20$parentElement = $entityRef->parentElement;
21
22// 親要素のタグ名を出力します
23echo $parentElement->tagName;
24
25?>

引数なし

引数はありません

DOMElement|null

このプロパティは、このエンティティ参照ノードの親要素を返します。親要素が存在しない場合は null を返します。