(PHP 4 >= 4.0.3, PHP 5)
pathinfo — ファイルパスに関する情報を返す
pathinfo() は、path に関する情報を有する連想配列を返します。
調べたいパス。
どの要素を返すのかをオプションのパラメータ options で指定します。これは PATHINFO_DIRNAME、 PATHINFO_BASENAME、 PATHINFO_EXTENSION および PATHINFO_FILENAME の組み合わせとなります。 デフォルトではすべての要素を返します。
以下の要素を含む連想配列を返します。 dirname (ディレクトリ名)、basename (ファイル名) そして、もし存在すれば extension (拡張子)。
options を使用すると、 すべての要素を選択しない限りこの関数の返り値は文字列となります。
| バージョン | 説明 |
|---|---|
| 5.2.0 | 定数 PATHINFO_FILENAME が追加されました。 |
例1 pathinfo() の例
<?php
$path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');
echo $path_parts['dirname'], "\n";
echo $path_parts['basename'], "\n";
echo $path_parts['extension'], "\n";
echo $path_parts['filename'], "\n"; // PHP 5.2.0 以降
?>
上の例の出力は以下となります。
/www/htdocs/inc lib.inc.php php lib.inc
注意:
カレントのパスに関する情報を取得するには、 定義済みの変数 のセクションをご覧ください。
注意:
pathinfo() はロケールを考慮して処理を行います。 マルチバイト文字を含むパスを正しく処理するには、正しいロケールを setlocale() 関数で設定しておかなければなりません。