• PHP Manual
  • Function Reference
  • File System Related Extensions
  • Filesystem
  • Filesystem Functions
  • basename
  • chgrp
  • chmod
  • chown
  • clearstatcache
  • copy
  • delete
  • dirname
  • disk_free_space
  • disk_total_space
  • diskfreespace
  • fclose
  • fdatasync
  • feof
  • fflush
  • fgetc
  • fgetcsv
  • fgets
  • fgetss
  • file
  • file_exists
  • file_get_contents
  • file_put_contents
  • fileatime
  • filectime
  • filegroup
  • fileinode
  • filemtime
  • fileowner
  • fileperms
  • filesize
  • filetype
  • flock
  • fnmatch
  • fopen
  • fpassthru
  • fputcsv
  • fputs
  • fread
  • fscanf
  • fseek
  • fstat
  • fsync
  • ftell
  • ftruncate
  • fwrite
  • glob
  • is_dir
  • is_executable
  • is_file
  • is_link
  • is_readable
  • is_uploaded_file
  • is_writable
  • is_writeable
  • lchgrp
  • lchown
  • link
  • linkinfo
  • lstat
  • mkdir
  • move_uploaded_file
  • parse_ini_file
  • parse_ini_string
  • pathinfo
  • pclose
  • popen
  • readfile
  • readlink
  • realpath
  • realpath_cache_get
  • realpath_cache_size
  • rename
  • rewind
  • rmdir
  • set_file_buffer
  • stat
  • symlink
  • tempnam
  • tmpfile
  • touch
  • umask
  • unlink
lchown
linkinfo
Filesystem Functions
PHP Manual

link

Create a hard link

Description

bool link(string $target, string $link)

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
  • readlink
  • linkinfo
  • unlink