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

関連コンテンツ

関連プログラミング言語