PHP 檔案系統 symlink() 函式



PHP 檔案系統 symlink() 函式用於從現有目標建立具有指定名稱連結的符號連結,並且它可以在成功時返回 true,或者在失敗時返回 false。

symlink() 函式不適用於遠端檔案,因為要檢查的檔案應透過伺服器的檔案系統可用。

語法

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

bool symlink ( string $target , string $link )

引數

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

序號 引數和描述
1

$target(必需)

它是連結的目標。

2

$link(必需)

它是連結名稱。

返回值

函式 symlink() 在成功時返回 TRUE,在失敗時返回 FALSE。

錯誤/異常

PHP stat() 函式在以下兩種情況下可能會給出錯誤和警告訊息:

  • 在嘗試建立之前,請驗證以確定連結是否已存在。
  • 如果目標檔案或資料夾不存在,則該函式無法在 Windows 計算機上使用。

PHP 版本

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

示例

這是一個基本示例,用於瞭解如何使用 PHP 檔案系統 symlink() 函式獲取提供的檔案或目錄的符號連結。

<?php
   $target = "/PhpProject/test.php";
   $link = "/test";
   symlink($target, $link);

   echo readlink($link);
?>

輸出

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

/PhpProject/test.php

示例

這是一個另一個示例,用於演示 symlink() 函式的使用,以建立提供的目錄的符號連結。

<?php
   // Path to the directory
   $target = '/PhpProject/testDirectory';
   $link = '/test';

   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink to directory created successfully!";
   } else {
      echo "Error creating symlink to directory.";
   }
?> 

輸出

這將產生以下結果:

Symlink to directory created successfully!

示例

這是一個使用 symlink() 函式建立具有相對路徑的符號連結的示例。

<?php
   // Relative path
   $target = '../PHP/target.txt'; 
   $link = '/PhpProjects/otherfile.txt';

   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink with relative path has been created successfully!";
   } else {
      echo "Error creating symlink with relative path.";
   }
?> 

輸出

這將生成以下輸出:

Symlink with relative path has been created successfully!

示例

這是一個使用 symlink() 函式處理使用此函式時發生的錯誤並根據錯誤列印錯誤的示例。

<?php
   $target = '../PHP/target.txt'; 
   $link = '/PhpProjects/otherfile.txt';

   
   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink created successfully!";
   } else {
      $error = error_get_last();
      echo "Error creating symlink: " . $error['message'];
   }
?> 

輸出

這將導致以下輸出:

Error creating symlink: symlink(): No such file or directory

總結

symlink() 方法是一個內建函式,用於為給定的檔案或目錄建立符號連結。

php_function_reference.htm
廣告