PHP 目錄 getcwd() 函式



PHP 目錄 getcwd() 函式用於檢索當前工作目錄。此目錄是腳本當前正在執行的位置。此函式的主要目的是告訴您指令碼在檔案系統中的位置。它不接受任何引數。該函式返回當前目錄路徑。

重要說明

如果任何父目錄的讀取模式或搜尋模式未設定,則 getcwd() 方法將失敗並在多個 Unix 作業系統中返回 FALSE。

語法

以下是 PHP 目錄 getcwd() 函式的語法:

string getcwd ( void );

引數

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

序號 引數及描述
1

void

該函式沒有引數。

返回值

成功時返回當前工作目錄,失敗時返回 FALSE。

PHP 版本

getcwd() 函式在核心 PHP 4 中引入,並與 PHP 5、PHP 7 和 PHP 8 相容。

示例

在此示例程式碼中,我們將使用 PHP 目錄 getcwd() 函式獲取當前工作目錄路徑。因此,它將簡單地列印當前工作目錄,後跟換行符。

<?php
   echo getcwd() . "\n";
   
   getcwd('html');
   
   echo getcwd() . "\n";
?> 

輸出

這將產生以下結果:

/home/tutorialspoint
/home/tutorialspoint/html

示例

在下面的 PHP 程式碼中,我們將 getcwd() 與 PHP 的預定義常量 DIRECTORY_SEPARATOR 一起使用來建立檔案的絕對路徑。DIRECTORY_SEPARATOR 常量包含當前平臺的目錄分隔符。

它將建立當前工作目錄中存在的名為 myfile.txt 檔案的完整路徑。

<?php
   $directory = getcwd();

   $file_path = $directory . DIRECTORY_SEPARATOR . 'myfile.txt';

   echo "Full path to file: " . $file_path;
?> 

輸出

這將建立以下結果:

Full path to file: /Applications/XAMPP/xamppfiles/htdocs/mac/myfile.txt

示例

現在我們將建立更改當前工作目錄並新增新工作目錄的程式碼,並使用 getcwd() 函式獲取新的工作目錄。

它列印“新工作目錄:”,後跟儲存在 $directory 中的新工作目錄的路徑。

<?php
   chdir('/Applications/XAMPP/xamppfiles/htdocs/mac/new dir');

   $directory = getcwd();
   
   echo "New current directory: " . $directory;
?> 

輸出

這將導致以下結果:

New current directory: /Applications/XAMPP/xamppfiles/htdocs/mac/new dir

示例

現在我們將瞭解如何處理如果使用 getcwd() 函式未獲取當前工作目錄的錯誤。我們將使用 if-else 語句來處理錯誤。因此,檢查 $dir 是否存在。如果不存在,則列印訊息“錯誤,無法獲取當前目錄”。

<?php
   $dir = getcwd();
   if ($dir === false) {
      echo "Error, Unable to get the current dir.";
   } else {
      echo "Current directory: " . $dir;
   }
?> 

輸出

此 PHP 程式碼的結果為:

Current directory: /Applications/XAMPP/xamppfiles/htdocs/mac

總結

這就是 getcwd() 函式在 PHP 中的工作方式。根據 getcwd() 函式的輸出,您可以執行其他與檔案和目錄相關的操作,例如列出目錄條目和生成檔案路徑。

php_function_reference.htm
廣告