PHP 檔案系統 pathinfo() 函式



PHP 檔案系統pathinfo()函式用於返回一個包含路徑資訊的陣列。如果未傳遞 options 引數,則返回一個包含以下元素的關聯陣列:dirname、basename、extension(如有)和 filename。

pathinfo()函式會識別計算機的語言和區域設定。要正確處理包含特殊字元的檔案路徑,請使用'setlocale()'函式選擇正確的語言和區域。

語法

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

mixed pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] )

引數

以下是pathinfo()函式的必需和可選引數:

序號 引數和描述
1

$path (必需)

要解析的路徑。

2

$options (可選)

指定要返回哪些資訊的整數。

  • PATHINFO_DIRNAME:返回目錄名。
  • PATHINFO_BASENAME:返回基本名(帶副檔名的檔名)。
  • PATHINFO_EXTENSION:返回副檔名。
  • PATHINFO_FILENAME:返回不帶副檔名的檔名。

返回值

pathinfo()函式返回有關路徑的資訊:根據 options,可能是關聯陣列或字串。

PHP 版本

pathinfo()函式首次作為 PHP 4.0.3 的核心部分引入,並與 PHP 5、PHP 7 和 PHP 8 相容。

示例

這是一個基本示例,演示如何使用 PHP 檔案系統pathinfo()函式解析路徑資訊。

<?php
   print_r(pathinfo("/PhpProjects/simple.txt"));
?>

輸出

以下是以下程式碼的結果:

Array
(
   [dirname] => /PhpProjects
   [basename] => simple.txt
   [extension] => txt
   [filename] => simple
)

示例

這是另一個示例,演示如何使用pathinfo()函式獲取給定路徑的資訊,我們還將在此處使用可選引數 PATHINFO_BASENAME 從路徑中獲取基本名。

<?php
   print_r(pathinfo("/PhpProjects/simple.txt", PATHINFO_BASENAME));
?> 

輸出

這將產生以下結果:

simple.txt

示例

這是一個使用所有可選引數在pathinfo()函式中獲取有關給定路徑的完整資訊的示例。

<?php
   $path = "/PhpProjects/myfile.txt";

   // Get only the directory name
   $dirname = pathinfo($path, PATHINFO_DIRNAME);
   echo "The only directory name: ".$dirname; 
   echo "\n";

   // Get only the base name
   $basename = pathinfo($path, PATHINFO_BASENAME);
   echo "The Base name only: ".$basename; 
   echo "\n";

   // Get only the file extension
   $extension = pathinfo($path, PATHINFO_EXTENSION);
   echo "The file extension: ".$extension; 
   echo "\n";

   // Get only the file name without the extension
   $filename = pathinfo($path, PATHINFO_FILENAME);
   echo "The filename without extension: ".$filename; 
?> 

輸出

這將生成以下輸出:

The only directory name: /PhpProjects
The Base name only: myfile.txt
The file extension: txt
The filename without extension: myfile

備註

使用pathinfo()函式時,請記住以下幾點:

  • pathinfo()對給定的字串進行簡單的操作,不瞭解實際檔案系統或路徑元件,例如“..” 。
  • 在 Windows 系統上,\ 字元用作目錄分隔符。在其他系統上,它將被視為任何其他字元。

總結

pathinfo()方法是一個內建函式,用於解析給定路徑的資訊。它非常有助於獲取有關特定路徑或檔案的確切資訊,例如其副檔名、資料夾位置和名稱。

php_function_reference.htm
廣告