dirname

說明

string dirname ( string path )

給出一個包括有指向一個檔案的全路徑的字串，本函數返回去掉檔案名後的目錄名。

在 Windows 中，斜線（/）和反斜線（\）都可以用作目錄分隔設定。在其它環境下是斜線（/）。

例子 1. dirname() 例子
<?php $path = "/etc/passwd"; $file = dirname($path); // $file is set to "/etc" ?>

注: 在 PHP 4.0.3 中，dirname() 被修正為 POSIX 相容。本質上就意味著若果在 path 中沒有斜線，則返回一個點（'.'），表示現用的目錄。否則返回的是把 path 中結尾的 /component（最後一個斜線以及後面部分）去掉之後的字串。注意這意味著在老的函數返回一個空字串的情形下通常從 dirname() 得到的是斜線或是一個點。

dirname() 從 PHP 4.3.0 開始有所改變。請看以下例子：


<?php

// PHP 4.3.0 以前
dirname('c:/'); // 返回 '.'

// PHP 4.3.0 以後
dirname('c:/'); // 返回 'c:'

?>

dirname() 的動作從 PHP 5.0.0 版開始是二進位安全的。

參見 basename()，pathinfo() 和 realpath()。