PHP 檔案系統 link() 函式



PHP 檔案系統link()函式用於為檔案建立硬連結。此函式主要用於本地檔案,不適用於遠端檔案。

硬連結是現有檔案的替代名稱。建立硬連結時,您將指向檔案內部的資料。這意味著主檔案和硬連結具有相同的資訊。如果刪除其中一個,資料仍然可以透過另一個訪問。

語法

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

bool link(string $target, string $link)

引數

以下是link()函式所需的的引數:

序號 引數及說明
1

$target(必需)

這是連結的目標。

2

$link(必需)

這是連結名。

返回值

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

PHP 版本

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

示例

這是一個基本的示例,演示如何使用 PHP 檔案系統link()函式建立符號連結。

<?php
    // Your target file
    $target = 'myfile.txt'; 
    
    // Give the name of the link
    $link = 'newfile';
    
    // Create a hard link for the target file
    link($target, $link);

    echo "Hard link has been created!"
?>

輸出

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

Hard link has been created!

示例

這是另一個示例,演示了link()函式的用法,使用以下程式碼可以建立硬連結。newfile.txt 是硬連結,myfile.txt 是原始檔案。

<?php
    $target = "/PhpProject/myfile.txt"; // Original file
    $link  = "/PhpProject/newfile.txt"; // hard link

    if (link($target, $link)) {
        echo 'Hard link created successfully.';
    } else {
        echo 'Failed to create hard link.';
    }
?> 

輸出

這將產生以下結果:

Hard link created successfully.

示例

這是一個處理使用link()函式時錯誤的示例。

<?php
    $target = "/PhpProject/myfile.txt"; // Original file
    $link  = "/PhpProject/newfile.txt"; // hard link

    if (link($target, $link)) {
        echo "Hard link created successfully.\n";
    } else {
        $error = error_get_last();
        echo "Failed to create hard link: " . $error['message'] . "\n";
    }
?> 

輸出

成功的情況下,將生成以下輸出:

Hard link created successfully.

失敗的情況下,將生成以下錯誤:

Failed to create hard link: Operation not permitted

總結

link()方法是一個內建函式,用於為檔案建立硬連結。成功時返回 true,失敗時返回 false。當您需要對單個檔案的多個引用時,此函式很有用,因為它可以防止資料重複。

php_function_reference.htm
廣告