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

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

作成日: 更新日:

基本的な使い方

URLプロパティは、Dom\HTMLDocumentクラスに属し、現在のドキュメントのURLを保持するプロパティです。Dom\HTMLDocumentクラスは、PHPのDOM拡張機能の一部として、HTMLドキュメントをオブジェクトとして表現し、プログラムからその構造や内容を操作するために使用されます。このURLプロパティは、そのDom\HTMLDocumentオブジェクトが表すHTMLドキュメントが、もともとどのウェブアドレス(URL)から読み込まれたものなのかという情報を提供します。

具体的には、ウェブサイトからHTMLコンテンツをダウンロードして解析する際や、既存のHTMLファイルを開いて処理する場合に、このプロパティを参照することで、そのドキュメントの出所となるURLを文字列として取得できます。例えば、複数のページをクロールして情報を収集するアプリケーションを開発している場合、各ページのHTMLドキュメントと紐付けられたURLを記録するのに役立ちます。また、埋め込みコンテンツやフレーム内のドキュメントの元のURLを特定する際にも有用です。

このプロパティは、常に文字列型の値を返します。もしドキュメントに関連するURLが存在しない場合、例えばメモリ上で新規に作成されたドキュメントや、ファイルシステムから直接読み込まれたドキュメントでURL情報が指定されていない場合などには、空の文字列が返されることがあります。システムエンジニアの皆様がHTMLドキュメントの来歴を正確に把握し、より堅牢なアプリケーションを構築するために重要な情報を提供します。

構文(syntax)

1<?php
2
3$htmlDocument = new Dom\HTMLDocument();
4$documentUrl = $htmlDocument->URL;
5
6?>

引数(parameters)

戻り値(return)

string

Dom\HTMLDocument クラスの URL プロパティは、HTML ドキュメントのベース URL を文字列として返します。

関連コンテンツ

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