PHP 文件系统 is_executable() 函数

---

---

PHP 文件系统is_executable()函数用于确定给定文件是否可执行。此函数只需要文件路径作为输入。

在 POSIX 系统（如 Linux 和 macOS）上，如果文件的权限中设置了可执行位，则该文件表示可执行。要检查文件权限，请在终端中使用 ls -l 程序。

在 Windows 系统上，情况略有不同。由于其权限的处理方式，它可能并不总是能准确反映文件是否可执行。通常建议使用不同的方法来验证 Windows 上的可执行文件。

语法

以下是 PHP 文件系统is_executable()函数的语法：

bool is_executable(string $filename)

参数

以下是is_executable()函数所需的参数：

返回值

如果文件名可执行且存在，则返回 true，否则返回 false。如果在文件权限中设置了可执行位，则在 POSIX 系统上该文件可执行。

PHP 版本

is_executable()函数最初作为 PHP 4 核心的一部分引入，并能很好地与 PHP 5、PHP 7 和 PHP 8 兼容。

示例

我们使用了 PHP 文件系统is_executable()函数来检查给定文件是否可执行。

<?php
   // Mention the file path here
   $file = '/PhpProjects/myfile.sh';

   if (is_executable($file)) {
       echo $file.' is executable';
   } else {
       echo $file.' is not executable';
   }
   
?>

输出

以下是以下代码的结果：

/PhpProjects/myfile.sh is executable

示例

下面的代码示例显示了如何使用 PHP 的is_executable()函数来检查文件是否具有可执行权限。$file = "/Applications/XAMPP/xamppfiles/bin/perl"; 行将路径赋值给变量 $file。此特定路径在运行 XAMPP 的计算机上打开 perl 可执行文件。

<?php
   //mention your path here
   $file = "/Applications/XAMPP/xamppfiles/bin/perl"; // Replace with path to an actual executable on your system

   if (is_executable($file)) {
   echo "The file '$file' is executable.";
   } else {
   echo "The file '$file' is not executable (unexpected).";
   }
?> 

输出

这将产生以下结果：

The file '/Applications/XAMPP/xamppfiles/bin/perl' is executable.

示例

在此 PHP 代码中，我们将使用is_executable()函数检查可能不存在的文件路径。因此，在这种情况下，is_executable()函数通常会返回 false，表明文件不存在或不可执行。

<?php
   //Mention your path here
   $file = "/Users/Desktop/My Docs/PHP/PhpProjects/index.php";

   if (is_executable($file)) {
   echo "The file '$file' is executable (unexpected).";
   } else {
   echo "The file '$file' does not exist or is not executable.";
   }
?> 

输出

这将生成以下结果：

The file '/User/PHP/PhpProjects/index.php' does not exist or is not executable.

示例

此示例显示了如何将 clearstatcache() 函数与is_executable()函数一起使用。假设您使用 chmod 复制更改文件的权限，然后验证文件是否可执行。由于is_executable()缓存结果，权限更改可能不会立即反映出来。

<?php
   // Mention multiple paths here
   $file = "/PhpProjects/script.sh"; // Modify this path to an actual file

   // Simulate permission change (replace with your permission modification logic)
   chmod($file, 0755);  // Grant all permissions (modify as needed)

   if (is_executable($file)) {
   echo "The file '$file' is executable.";
   } else {
   echo "The file '$file' is not executable.";

   // Clear cache and re-check (uncomment if needed)
   clearstatcache($file);

   if (is_executable($file)) {
      echo "Executable after clearing cache (possible race condition)";
      }
   }
?> 

输出

这将产生以下输出：

#Script Exists and Initially Executable
The file '/PhpProjects/script.sh' is executable.

#Script Exists but Not Initially Executable
The file '/PhpProjects/script.sh' is not executable.

#Script Does not Exist
The file '/PhpProjects/script.sh' is not executable.

注意

与 Win API GetBinaryType() 类似，如果以 .bat 或 .cmd 结尾的文件是有效的可执行文件，则在 Windows 上它们也会被识别为可执行文件。这是由于向后兼容性的强制行为。在 PHP 7.4.0 之前，每个以 .exe 或 .com 结尾的非空文件都被认为是可执行文件。请记住，PATHEXT 与is_executable()无关。

总结

is_executable()函数是用于检查给定文件在 PHP 中是否可执行的强大函数。PHP 将is_executable()的结果保存在缓存中以提高性能。这意味着如果您使用相同的文件名多次调用该函数，它将返回缓存的结果，而不是重新检查文件系统。