PHP | función de enlace simbólico()

La función symlink() en PHP es una función incorporada que se usa para crear un enlace simbólico para un objetivo que ya existe. Ayuda a crear un enlace de nombre específico para un objetivo. 
Los nombres de destino y enlace se envían como parámetros a la función symlink() y devuelve True en caso de éxito y False en caso de falla. 
La función symlink() no proporciona un enlace HTML, sino un enlace en el sistema de archivos.
Sintaxis:  

symlink(target, link)

Parámetros usados: 
La función symlink() en PHP acepta dos parámetros.  

1. target : Es un parámetro obligatorio que especifica el destino cuyo enlace se debe crear.
2. enlace: Es un parámetro obligatorio que especifica el nombre del enlace.

Valor devuelto: 
Devuelve True en caso de éxito y False en caso de error.
Errores y excepciones  

1. La función symlink() no funciona si el sistema en el que ejecuta PHP es anterior a Windows Vista/Windows Server 2008.
2. La función symlink() acepta solo rutas absolutas en Windows. Las rutas relativas en las ventanas no son compatibles con los enlaces simbólicos.
3. La función symlink() devuelve Boolean False, pero muchas veces sucede que devuelve un valor no booleano que se evalúa como False.

Ejemplos: 

Input : $target_pointer = 'gfg.txt';
        $link_name = 'geeksforgeeks';
        symlink($target_pointer, $link_name);
Output : 1

Input : $target_pointer = "/home/user1/gfg.txt";
        $link_name = 'mylink';
        $test = symlink($target_pointer, $link_name);
        if ($result) 
        {
          echo ("Symlink has been created!");
        }
        else 
        {
          echo ("Symlink cannot be created!");
        }
Output : Symlink has been created!

Los siguientes programas ilustran la función symlink().
Supongamos que hay un archivo llamado ‘gfg.txt’
Programa 1

<?php
// specifying target
$target_pointer = 'gfg.txt';
 
// specifying link  name
$link_name = 'geeksforgeeks';
 
// creating alink using symlink() function
symlink($target_pointer, $link_name);
?>

Producción:  

1

Programa 2

<?php
// specifying target
$target_pointer = "/home/user1/gfg.txt";
 
// specifying link  name
$link_name = 'mylink';
 
// creating alink using symlink() function
$test = symlink($target_pointer, $link_name);
if ($result)
{
   echo ("Symlink has been created!");
}
else
{
   echo ("Symlink cannot be created!");
}
 
?>

Producción:  

Symlink has been created!

Referencia:  
http://php.net/manual/en/function.symlink.php