PHP 檔案系統 dirname() 函式



PHP 檔案系統dirname()函式用於獲取檔案路徑的目錄部分。在處理檔案路徑並希望將目錄路徑與檔名分開時,此函式非常有用。dirname()返回包含您指定為檔案路徑的檔案的目錄的路徑。此外,您可以選擇要遍歷的目錄級別數。

dirname()函式的常見用例包括組織檔案路徑、導航目錄以及管理PHP應用程式中的檔案系統結構。

語法

以下是PHP檔案系統dirname()函式的語法:

string dirname ( string path, int levels )

引數

使用dirname()函式所需的引數如下所示:

序號 引數及說明
1

path (必需)

這是檔案的路徑。

2

levels (可選)

此引數顯示您要訪問的目錄級別數。預設情況下,它返回1,即直接父目錄。如果將其設定為2,它將向上移動兩個級別,依此類推。

返回值

該函式返回一個包含給定檔案路徑的目錄路徑的字串。

PHP 版本

dirname()函式最初作為PHP 4核心的一部分引入,並與PHP 5、PHP 7、PHP 8良好相容。

示例

首先,我們將瞭解PHP檔案系統dirname()函式的簡單用法。我們將簡單地輸出dirname()函式中指定路徑的dirname()。

<?php
   echo dirname("C:/PhpProject/index.php") . "\n";
   echo dirname("/PhpProject/index.php");
?>

輸出

這將產生以下結果:

C:/PhpProject
/PhpProject

示例

在下面的程式碼中,我們將看到如何透過使用dirname()函式的可選引數,在給定的目錄路徑中向上移動多個目錄級別。

<?php
   // define file path here
   $filePath = "/var/www/html/index.php";

   // use dirname function and pass both the parameters
   $parentDirectory = dirname($filePath, 2);

   // print the parent directory detail
   echo $parentDirectory; 
?> 

輸出

這將生成以下輸出:

/var/www

示例

此示例演示如何使用dirname()函式獲取當前指令碼檔案的目錄。我們使用了PHP魔術常量__FILE__,它表示當前正在執行的指令碼的完整路徑和檔名。因此,dirname(__FILE__)可用於確定當前指令碼檔案的目錄名。

<?php
   $sdir = dirname(__FILE__);
   echo $sdir; 
?> 

輸出

這將導致以下結果:

/Applications/XAMPP/xamppfiles/htdocs/mac

注意

  • dirname()可在基於Unix和Windows的平臺上使用。它對Windows使用\,對Unix使用/作為目錄分隔符。
  • 它可以與絕對路徑或相對路徑一起使用。例如,可以使用dirname("documents/file.txt")來處理文件。

總結

使用dirname()獲取檔案路徑的目錄名。如果您需要建立一個備份目錄,請使用dirname()獲取父目錄,然後在其內部建立備份資料夾。

php_function_reference.htm
廣告