php man page for link

LINK(3) 								 1								   LINK(3)

link - Create a hard link

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

DESCRIPTION
       link(3) creates a hard link.

PARAMETERS
	      o $target
		- Target of the link.

	      o $link
		- The link name.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

CHANGELOG
       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  This  function is now available on Windows plat- |
       |	| forms (Vista, Server 2008 or greater).	    |
       |	|						    |
       +--------+---------------------------------------------------+
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(3), readlink(3), linkinfo(3).

PHP Documentation Group 														   LINK(3)