Edit Report a Bug

link

(PHP 4, PHP 5, PHP 7)

link — Create a hard link

Descrierea

link ( string $target , string $link ) : bool

link() creates a hard link.

Parametri

target: Target of the link.
link: The link name.

Valorile întoarse

Întoarce valoarea true în cazul succesului sau false în cazul eșecului.

Erori/Excepții

The function fails, and issues E_WARNING, if link already exists, or if target does not exist.

Exemple

Example #1 Creating a simple hard link


<?php
$target = 'source.ext'; // This is the file that already exists
$link = 'newfile.ext'; // This the filename that you want to link it to

link($target, $link);
?>

Note

Notă: Această funcție nu va lucra cu fișiere la distanță, deoarece fișierul care trebuie să fie examinat trebuie să fie accesibil prin intermediul sistemului de fișiere al serverului.

Notă: For Windows only: This function requires PHP to run in an elevated mode or with the UAC disabled.

A se vedea și

symlink() - Creates a symbolic link
readlink() - Returns the target of a symbolic link
linkinfo() - Gets information about a link
unlink() - Deletes a file

add a note

User Contributed Notes 4 notes

down

Anonymous ¶

15 years ago


to clarify:

in unix/linux:
hardlinks (by this function) cannot go across different filesystems.
softlinks can point anywhere.

in linux, hardlinking to directory is not permited.

down

-2

Jasper Bekkers ¶

18 years ago


For a backup utility I needed link-like functionality on a windows system. As it isn't availible on windows, i tried to do it myself with the help of some tools. All you need is junction.exe from sysinternals in your %PATH%.

<?php
if(!function_exists('link')){ // Assume a windows system
    function link($target, $link){
        if(is_dir($target)){
            // junctions link to directories in windows
            exec("junction $link $target", $lines, $val);
            return 0 == $val;
        }elseif(is_file($target)){
            // Hardlinks link to files in windows
            exec("fsutil hardlink create $link $target", $lines, $val);
            return 0 == $val;
        }
        
        return false;
    }
}
?>

http://www.sysinternals.com/Utilities/Junction.html

down

-3

Guilherme Garnier ¶

18 years ago


I noticed that, differently from Unix ln command, the second parameter can´t be a directory name, i.e., if you want to create a link with the same filename of the target file (obviously on different directories), you must specify the filename on the link parameter.

Example:
Unix ln command:
ln /dir1/file /dir2/   // ok, creates /dir2/file link

PHP link function:
link ("/dir1/file", "/dir2/");   // wrong, gives a "File exists" warning
link ("/dir1/file", "/dir2/file");   // ok, creates /dir2/file link

down

-2

crashulater at virtualcrash dot com ¶

6 years ago


In at least php-5.3 (linux-2.6.38.6) a process owned by apache could make a link() in a directory owned by apache, to a file owned by webmaster to which it had group read permissions. In php-7.0 (linux-4.13.16) that results in a "permission denied". Either the target file must be owned by apache or one must use copy() instead (so that ownership changes to apache).

add a note