HOWTO · PHP
在 PHP 中獲取當前目錄名稱和路徑
本教程介紹如何在 PHP 中獲取當前目錄名和路徑。
本頁內容
在 PHP 中處理目前路徑有幾種方法,該選哪一種取決於「目前」指的是什麼。getcwd() 會回傳程序的工作目錄;__DIR__ 則指出目前 PHP 檔案所在的目錄。若指令碼從其他目錄啟動,或由另一個檔案引入,這兩個位置可能不同。若要從路徑取得上層目錄,請使用 dirname();若只需要路徑的最後一個部分,則使用 basename()。
使用 getcwd() 取得目前工作目錄
呼叫 getcwd() 可將程序的工作目錄以路徑字串形式取回。許多相對檔案系統路徑會以此目錄為基準,但它不一定是指令碼檔案所在的目錄。include 和 require 還會依據其他查找規則,例如 include_path 和呼叫端檔案所在的目錄,因此光靠 getcwd() 無法說明所有引入路徑的解析方式。舉例來說,命令列程序可能從 /srv/app 啟動,並執行存放於 /srv/app/bin 的指令碼;在這種情況下,getcwd() 會指向 /srv/app。這些路徑僅供說明,因為工作目錄取決於程序的啟動方式,也可能在執行期間變更。
執行此範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$workingDirectory = getcwd();
if ($workingDirectory !== false) {
echo $workingDirectory;
}
?>
只要 PHP 能判定工作目錄,範例就會印出程序的工作目錄路徑。其絕對路徑取決於程序的啟動方式。在應用程式程式碼中,使用前請先檢查 getcwd() 的結果:若 PHP 無法判定工作目錄,此函式會回傳 false。在串接路徑或將結果傳給檔案操作之前,請先處理這種情況。
使用 DIR 取得目前指令碼目錄
魔術常數 __DIR__ 會提供它所在 PHP 檔案的目錄。與 getcwd() 不同,即使程序從其他位置啟動,__DIR__ 仍會指向該檔案所在的目錄。如果 bootstrap.php 引入 lib/config.php,寫在 config.php 裡的 __DIR__ 會指向 config.php 所在的目錄,而不是 bootstrap.php 所在的目錄,也不一定是程序的工作目錄。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$scriptDirectory = __DIR__;
echo $scriptDirectory;
?>
若要存取與目前指令碼一同部署的檔案,這個常數就很實用。例如,指令碼可以從 $scriptDirectory 建立通往同層資源的路徑,不受啟動目錄影響。顯示的絕對路徑會因安裝位置而異,因此此範例沒有固定的輸出值。dirname(__FILE__) 也能取得目前檔案所在的目錄;__FILE__ 則是該檔案的完整路徑。
使用 dirname() 從路徑取得目錄
如果已有一個路徑,並需要取得它的上層目錄,可以使用 dirname()。將它套用至 __DIR__,會移至目前檔案所在目錄的上一層;套用至 __FILE__,則會回傳檔案所在的目錄。此函式只處理路徑字串,不會確認結果目錄是否存在。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$parentDirectory = dirname(__DIR__);
echo $parentDirectory;
?>
若檔案位於 /srv/app/src 下,這種寫法會取得 /srv/app。範例路徑僅供參考;實際結果取決於 PHP 檔案的位置。若資源存放於上層資料夾,可將取得的路徑作為基底;若操作需要目錄確實存在,請另外確認檔案系統存取情況。
使用 basename() 取得目錄名稱
basename() 會回傳所提供路徑的最後一個部分。對於 /var/www/project 這類目錄路徑,它會回傳 project,而不是完整路徑。若提供 /var/www/project/config.php 這類檔案路徑,它會回傳檔名 config.php。因此,根據輸入路徑不同,同一個函式可以擷取目錄名稱或檔名。
若只需要最後一個部分來顯示或比較,可以使用 basename()。執行檔案操作時,請保留原始完整路徑:單靠最後一個部分無法識別唯一位置,而且檔案系統中的不同目錄可能有相同名稱。
根據工作需求選擇適合的路徑
- 若相對路徑應以程序的工作目錄為基準,請使用
getcwd()。使用前先檢查它是否回傳失敗值false。 - 若路徑應以 PHP 檔案本身為基準,請使用
__DIR__,包括透過include或require載入的程式碼。 - 若要從
__DIR__、__FILE__或其他路徑取得上層目錄,請使用dirname()。 - 若只需要路徑的最後一個部分,請使用
basename();尋找資源時則保留完整路徑。
對於與應用程式一同存放的設定檔、範本和其他資源,以 __DIR__ 建立路徑通常比以程序的工作目錄為基準更可靠。若呼叫端會刻意控制工作目錄,例如命令列工具要操作指定資料夾,則可使用 getcwd()。