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

baseURIプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月25日

基本的な使い方

Dom\TextクラスのbaseURIプロパティは、ノードのベースURI（Uniform Resource Identifier）を保持するプロパティです。このプロパティは、テキストノードが属するドキュメントまたは要素の基準となるURIを提供します。具体的には、テキストノードが外部エンティティ（例えば、外部スタイルシートや画像）から読み込まれた場合、そのエンティティの場所を示すURIがこのプロパティに格納されます。

baseURIプロパティの値は、文字列として表現され、絶対URIまたは相対URIのいずれかになります。相対URIの場合、そのURIはドキュメント自体の場所を基準に解決する必要があります。もしテキストノードが外部エンティティから読み込まれていない場合、またはドキュメントにベースURIが設定されていない場合、このプロパティは空文字列を返します。

システムエンジニアを目指す上で、baseURIプロパティは、XMLやHTMLドキュメントを扱う際に、外部リソースの場所を特定し、適切に処理するために重要な役割を果たします。例えば、外部スタイルシートのパスを動的に変更したり、画像ファイルの場所を基準に相対パスを解決したりする際に利用できます。

このプロパティは読み取り専用であり、値を直接変更することはできません。テキストノードのベースURIを変更するには、ドキュメント自体のベースURIを変更するか、テキストノードが属する要素の属性を操作する必要があります。

構文(syntax)


1<?php
2
3$document = new Dom\Document();
4$document->loadHTML('<html><body><p>Hello</p></body></html>');
5
6$paragraph = $document->getElementsByTagName('p')->item(0);
7$textNode = $paragraph->firstChild;
8
9// Dom\Text オブジェクトの baseURI プロパティの値を取得します
10$baseUri = $textNode->baseURI;
11
12var_dump($baseUri);
13
14?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このプロパティは、このテキストノードの基本URIを表す文字列を返します。