【PHP8.x】PHP_URL_PATH定数の使い方

PHP_URL_PATH定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年03月09日

基本的な使い方

PHP_URL_PATH定数は、URL（Uniform Resource Locator）の「パス」部分を表す定数です。この定数は、PHPが提供する組み込み関数であるparse_url()関数と組み合わせて使用されることを想定しています。parse_url()関数は、与えられたURL文字列をその構成要素、例えばスキーム（httpやhttps）、ホスト名（ドメイン）、ポート番号、ユーザー名、パス、クエリ文字列、フラグメントといった部分に分解し、個々の情報を取得するために利用されます。

特に、PHP_URL_PATHをparse_url()関数の第二引数として指定することで、完全なURLからウェブサーバー上の特定のリソースの場所を示すパス部分のみを効率的に抽出することができます。例えば、「https://www.example.com/products/item123.html?color=red」というURLがあった場合、/products/item123.htmlの部分がパスに該当します。この定数を用いることで、このようなURLのパス情報を簡単に取得し、PHPアプリケーション内で利用することが可能になります。

ウェブアプリケーション開発において、リクエストされたURLのパスに基づいて処理を分岐させたり、特定のファイルやディレクトリへのアクセスを管理したりする際に、URLのパス部分を正確に取得する場面が多々あります。PHP_URL_PATH定数は、そのようなシナリオでURLの構造を解析し、プログラムのロジックをより柔軟かつ堅牢に構築するための基本的なツールとして非常に役立ちます。

構文(syntax)


1$url = 'https://www.example.com/path/to/page.html?name=value#section';
2$path = parse_url($url, PHP_URL_PATH);
3echo $path;

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

PHP_URL_PATHは、URLのパス部分を示す整数定数です。

サンプルコード

PHP parse_urlでURLのパスを抽出する


1<?php
2
3/**
4 * 指定されたURLからパス部分を抽出する関数。
5 *
6 * この関数はPHPのparse_url関数とPHP_URL_PATH定数を使用して、
7 * URLのパスコンポーネントのみを取得する方法を示します。
8 *
9 * @param string $url 解析対象の完全なURL文字列。
10 * @return string|null URLのパス部分。解析に失敗した場合やパスが存在しない場合はnullを返します。
11 */
12function getUrlPath(string $url): ?string
13{
14    // parse_url関数を使用してURLを解析します。
15    // 第二引数にPHP_URL_PATH定数を指定することで、パス部分のみが抽出されます。
16    // PHP_URL_PATHは、URL構造におけるパス要素（例: /dir/file.html）を識別する定数です。
17    $path = parse_url($url, PHP_URL_PATH);
18
19    // parse_urlは、解析に失敗した場合や指定されたURLコンポーネントが存在しない場合に
20    // falseまたはnullを返すことがあります。
21    // そのような場合は、関数としてnullを返して呼び出し元に通知します。
22    if ($path === false) {
23        return null;
24    }
25
26    return $path;
27}
28
29// --- サンプル使用例 ---
30
31// 完全なURL
32$sampleUrl1 = 'https://www.example.com/users/profile.php?id=123&name=test#section';
33$path1 = getUrlPath($sampleUrl1);
34echo "URL: " . $sampleUrl1 . PHP_EOL;
35echo "抽出されたパス: " . ($path1 ?? 'パスなし/解析失敗') . PHP_EOL . PHP_EOL;
36
37// ホストとパスのみのURL
38$sampleUrl2 = 'http://api.example.org/v1/data';
39$path2 = getUrlPath($sampleUrl2);
40echo "URL: " . $sampleUrl2 . PHP_EOL;
41echo "抽出されたパス: " . ($path2 ?? 'パスなし/解析失敗') . PHP_EOL . PHP_EOL;
42
43// クエリパラメータのみでパスがないURL（実際にはルートパスと解釈される）
44$sampleUrl3 = 'http://example.net/?param=value';
45$path3 = getUrlPath($sampleUrl3);
46echo "URL: " . $sampleUrl3 . PHP_EOL;
47echo "抽出されたパス: " . ($path3 ?? 'パスなし/解析失敗') . PHP_EOL . PHP_EOL;
48
49// 不正な形式のURL
50$invalidUrl = 'not-a-valid-url-string';
51$pathInvalid = getUrlPath($invalidUrl);
52echo "URL: " . $invalidUrl . PHP_EOL;
53echo "抽出されたパス: " . ($pathInvalid ?? 'パスなし/解析失敗') . PHP_EOL . PHP_EOL;
54
55?>

このPHPサンプルコードは、与えられたURL文字列から「パス」と呼ばれる部分を抽出する方法を示しています。URLのパスは、ウェブサイトのドメイン名の後に続くディレクトリやファイル名に相当する部分です。

コードの中心となるのは、PHPの組み込み関数parse_urlと定数PHP_URL_PATHです。parse_url関数は、指定されたURLを構成要素（スキーム、ホスト、ポート、パス、クエリ、フラグメントなど）に分解します。この関数に第二引数としてPHP_URL_PATH定数を渡すことで、URL全体から特にパスの部分だけを効率的に取り出すことができます。PHP_URL_PATHは、URLのどの部分を抽出するかを指定するための特別な数値（整数）を持つ定数です。

getUrlPath関数は、引数として解析対象のURL文字列を受け取ります。そしてparse_urlを呼び出し、抽出されたパスを文字列として返します。もしURLの解析に失敗した場合や、URLにパス部分が存在しないと判断された場合は、nullを返して呼び出し元にその状況を伝えます。例えば、「https://www.example.com/users/profile.php?id=123」のようなURLからは「/users/profile.php」が、また「http://api.example.org/v1/data」からは「/v1/data」がパスとして抽出されます。クエリパラメータのみでパスがないように見えるURL「http://example.net/?param=value」の場合も、ルートパス「/」として扱われます。不正な形式の文字列が渡された場合は、パスは抽出されず`null`が返されます。これにより、システム開発においてURLの特定のコンポーネントを安全かつ正確に扱うことが可能になります。

PHP_URL_PATH定数は、parse_url関数と組み合わせてURLのパス部分のみを抽出する際に利用します。parse_url関数は、URLの解析に失敗した場合や指定されたURLコンポーネントが存在しない場合にfalseを返す可能性があります。そのため、戻り値がfalseではないか必ず確認し、適切にエラーを処理するよう注意が必要です。このサンプルコードでは、falseをnullに変換して返しています。また、URLに明示的なパスがない場合（例: http://example.com/?param=value）、parse_urlはパスとしてルートを表す/を返す点も理解しておきましょう。不正な形式のURLに対しては解析が失敗するため、入力値の検証も重要になります。