【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を表す文字列を返します。