PHP 文件系统 symlink() 函数



PHP 文件系统 symlink() 函数用于从现有目标创建具有指定名称链接的符号链接,并且它可以在成功时返回 true,或者在失败时返回 false。

symlink() 函数不适用于远程文件,因为要检查的文件应通过服务器的文件系统可用。

语法

以下是 PHP 文件系统 symlink() 函数的语法:

bool symlink ( string $target , string $link )

参数

以下是 symlink() 函数的必需和可选参数:

序号 参数和描述
1

$target(必需)

它是链接的目标。

2

$link(必需)

它是链接名称。

返回值

函数 symlink() 在成功时返回 TRUE,在失败时返回 FALSE。

错误/异常

PHP stat() 函数在以下两种情况下可能会给出错误和警告消息:

  • 在尝试创建之前,请验证以确定链接是否已存在。
  • 如果目标文件或文件夹不存在,则该函数无法在 Windows 计算机上使用。

PHP 版本

symlink() 函数最初作为核心 PHP 4 的一部分引入,并且与 PHP 5、PHP 7 和 PHP 8 兼容良好。

示例

这是一个基本示例,用于了解如何使用 PHP 文件系统 symlink() 函数获取提供的文件或目录的符号链接。

<?php
   $target = "/PhpProject/test.php";
   $link = "/test";
   symlink($target, $link);

   echo readlink($link);
?>

输出

以下是以下代码的结果:

/PhpProject/test.php

示例

这是一个另一个示例,用于演示 symlink() 函数的使用,以创建提供的目录的符号链接。

<?php
   // Path to the directory
   $target = '/PhpProject/testDirectory';
   $link = '/test';

   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink to directory created successfully!";
   } else {
      echo "Error creating symlink to directory.";
   }
?> 

输出

这将产生以下结果:

Symlink to directory created successfully!

示例

这是一个使用 symlink() 函数创建具有相对路径的符号链接的示例。

<?php
   // Relative path
   $target = '../PHP/target.txt'; 
   $link = '/PhpProjects/otherfile.txt';

   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink with relative path has been created successfully!";
   } else {
      echo "Error creating symlink with relative path.";
   }
?> 

输出

这将生成以下输出:

Symlink with relative path has been created successfully!

示例

这是一个使用 symlink() 函数处理使用此函数时发生的错误并根据错误打印错误的示例。

<?php
   $target = '../PHP/target.txt'; 
   $link = '/PhpProjects/otherfile.txt';

   
   // Create symlink
   if (symlink($target, $link)) {
      echo "Symlink created successfully!";
   } else {
      $error = error_get_last();
      echo "Error creating symlink: " . $error['message'];
   }
?> 

输出

这将导致以下输出:

Error creating symlink: symlink(): No such file or directory

总结

symlink() 方法是一个内置函数,用于为给定的文件或目录创建符号链接。

php_function_reference.htm
广告