【PHP8.x】baseURIプロパティの使い方
baseURIプロパティの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
baseURIプロパティは、Dom\Documentオブジェクトに関連付けられたドキュメントのベースURI(Uniform Resource Identifier)を保持するプロパティです。ベースURIは、ドキュメント内の相対URIを絶対URIに解決するために使用されます。
具体的には、HTMLドキュメント内で <img src="image.jpg"> のように相対パスで指定された画像ファイルを参照する場合、image.jpg が指す実際の場所を特定するために、ベースURIが用いられます。ベースURIが http://example.com/path/to/ であれば、上記の画像ファイルの絶対URIは http://example.com/path/to/image.jpg となります。
このプロパティの値は文字列型で、ドキュメントの生成時に設定されるか、または後からスクリプトによって変更されることがあります。もしドキュメントがファイルから読み込まれた場合、通常、ファイルの位置がベースURIとして設定されます。
Dom\DocumentオブジェクトのbaseURIプロパティを参照することで、ドキュメントの相対URI解決の基準となるURIを確認できます。また、DOMDocument::loadHTML()やDOMDocument::loadXML()などのメソッドを使用してドキュメントをロードする際に、オプションとしてベースURIを指定することも可能です。ベースURIが明示的に指定されない場合、ドキュメントがロードされた場所に基づいて自動的に決定されます。
システム開発においては、特に外部リソースを参照するHTMLドキュメントを扱う際に、このプロパティの理解が重要となります。誤ったベースURIが設定されていると、画像やスタイルシートなどのリソースが正しく読み込まれず、意図しない表示結果となる可能性があります。
構文(syntax)
1readonly public string $baseURI;
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
Dom\Document クラスの baseURI プロパティは、このドキュメントの基底 URI を表す文字列を返します。