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

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

作成日: 更新日:

基本的な使い方

baseURIプロパティは、PHPのDOM拡張機能において、DOMツリー内の文字データを扱うノードが属する文書の基準となるURI(Uniform Resource Identifier)を保持するプロパティです。このプロパティは、DOMCharacterDataクラスに属しており、テキストノードやコメントノードといった、ドキュメント内の文字情報を含む要素に対して利用されます。

具体的には、XMLやHTMLドキュメント内で相対パス形式で指定されたURL(例えば、画像ファイルのパスやリンク先など)を絶対パスに変換する際に、どのURIを基準として解釈すれば良いかを示す役割を持っています。例えば、ウェブページ上で「images/photo.jpg」のような相対パスがあった場合、baseURIが「http://example.com/」であれば、完全なURLは「http://example.com/images/photo.jpg」と解決されます。

このbaseURIの値は、通常、そのノードが属するドキュメント自体のURIとなりますが、XMLのxml:base属性が特定のノードに設定されている場合や、異なるURIを持つ外部ドキュメントからノードがインポートされた場合には、そのノード固有の基準URIを示すことがあります。システムエンジニアにとって、特にXML文書の解析や操作において、相対URIの正確な解決が必要な場合に重要な情報となります。このプロパティは読み取り専用であり、その値を直接変更することはできません。

構文(syntax)

1<?php
2$domDocument = new DOMDocument();
3$textNode = $domDocument->createTextNode('Sample text data.');
4$domDocument->appendChild($textNode);
5
6echo $textNode->baseURI;
7?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMCharacterData::baseURI プロパティは、このノードが属するドキュメントのベースURIを表す文字列を返します。

【PHP8.x】baseURIプロパティの使い方 | いっしー@Webエンジニア