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

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

作成日: 更新日:

基本的な使い方

documentURIプロパティは、PHPのDom\HTMLDocumentクラスに属し、そのHTMLドキュメントのUniform Resource Identifier (URI) を保持するプロパティです。URIとは、ウェブ上のリソースを一意に識別するための文字列のことで、具体的にはウェブページのアドレス(URL)などがこれにあたります。

このプロパティを利用することで、現在プログラムで扱っているHTMLドキュメントが、ファイルシステム上のどこにあるのか、あるいはインターネット上のどのURLから取得されたものなのかを、文字列として確認することができます。Dom\HTMLDocumentクラスは、HTMLドキュメントをプログラムで操作できるようにするためのもので、このdocumentURIプロパティは、ドキュメントの生成元や現在のコンテキストを把握する上で重要な情報を提供します。

例えば、外部から読み込んだHTMLドキュメントを解析する際に、そのドキュメントの元のURIを知ることで、相対パスで記述されたリンクや画像などのリソースの絶対パスを解決する基準として利用できます。また、どのドキュメントを操作しているのかをログに出力したり、デバッグ情報を表示したりする際にも役立ちます。このプロパティは通常、読み取り専用であり、ドキュメントが読み込まれた後にそのURIを直接変更することはできません。システムエンジニアを目指す方々が、PHPでウェブコンテンツの操作や解析を行う際には、ドキュメントの出所を正確に把握するために、このdocumentURIプロパティの役割を理解することが大切です。

構文(syntax)

1<?php
2$htmlDocument = new Dom\HTMLDocument();
3$uri = $htmlDocument->documentURI;

引数(parameters)

戻り値(return)

string

このプロパティは、HTMLドキュメントのURI(Uniform Resource Identifier)を文字列で返します。URIは、ドキュメントがどこから取得されたかを示すアドレスのようなものです。

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