array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.link.php', 1 => 'link', 2 => 'Create a hard link', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Filesystem Functions', ), 'prev' => array ( 0 => 'function.lchown.php', 1 => 'lchown', ), 'next' => array ( 0 => 'function.linkinfo.php', 1 => 'linkinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/filesystem/functions/link.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

link

(PHP 4, PHP 5, PHP 7, PHP 8)

link — Create a hard link

Description

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

link() creates a hard link.

Parameters

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

Return Values

Returns true on success or false on failure.

Errors/Exceptions

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

Examples

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);
?>

Notes

Note: This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

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

See Also

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