無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

pathinfo

(PHP 4 >= 4.0.3, PHP 5)

pathinfoファイルパスに関する情報を返す

説明

mixed pathinfo ( string $path [, int $options ] )

pathinfo() は、path に関する情報を有する連想配列を返します。

パラメータ

path

調べたいパス。

options

どの要素を返すのかをオプションのパラメータ options で指定します。これは PATHINFO_DIRNAMEPATHINFO_BASENAMEPATHINFO_EXTENSION および PATHINFO_FILENAME の組み合わせとなります。 デフォルトではすべての要素を返します。

返り値

以下の要素を含む連想配列を返します。 dirname (ディレクトリ名)、basename (ファイル名) そして、もし存在すれば extension (拡張子)。

options を使用すると、 すべての要素を選択しない限りこの関数の返り値は文字列となります。

変更履歴

バージョン 説明
5.2.0 定数 PATHINFO_FILENAME が追加されました。

例1 pathinfo() の例

<?php
$path_parts 
pathinfo('/www/htdocs/index.html');

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
index.html
html
index

注意

注意: カレントのパスに関する情報を取得するには、 定義済みの変数 のセクションをご覧ください。