PHP - Manual: is_executable

2025-11-01

is_file »

« is_dir

is_executable

(PHP 4, PHP 5, PHP 7, PHP 8)

is_executable — 判断给定文件名是否可执行

说明

is_executable(string $filename): bool

判断给定文件名是否可执行。

参数

filename: 文件的路径。

返回值

如果文件存在且可执行则返回 true，错误时返回 false。在 POSIX 系统中，如果设置了文件权限的可执行位，则文件可执行。对于 Windows，请参阅下面的注释。

错误／异常

失败时抛出 E_WARNING 警告。

示例

示例 #1 is_executable() 例子

<?php

$file = '/home/vincent/somefile.sh';

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

?>

注释

注意: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。

小技巧

自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。

注意: 在 Windows 上，如果文件是 Win API GetBinaryType() 报告的正确可执行文件，则该文件视为可执行文件；由于 BC 原因，扩展名是 .bat 或 .cmd 的文件也被视为可执行文件。在 PHP 7.4.0 之前，任何扩展名是 .bat 或 .cmd 的非空文件都被视为可执行文件。注意 PATHEXT 与 is_executable() 无关。

参见

is_file() - 判断给定文件名是否为一个正常的文件
is_link() - 判断给定文件名是否为一个符号连接

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 5 notes

down

divinity76 at gmail dot com ¶

5 years ago

is_executable() does not check the PATH environment variable, so if your current working dir is /dir/ and you have /bin/ in your PATH env and the file /bin/ffmpeg exists, then you can still run shell_exec("ffmpeg"), but is_executable("ffmpeg") will return false.


if you're looking for a version of is_executable that also considers the PATH environment variable, then try this:


<?php


function is_executable_pathenv(string $filename): bool

{

    if (is_executable($filename)) {

        return true;

    }

    if ($filename !== basename($filename)) {

        return false;

    }

$paths = explode(PATH_SEPARATOR, getenv("PATH"));

    foreach ($paths as $path) {

        if (is_executable($path . DIRECTORY_SEPARATOR . $filename)) {

            return true;

        }

    }

    return false;

}

down

Shyammakwana.me ¶

8 years ago

For windows users, 

It will return TRUE for EXE extensions. I have checked for MSI, but it returns FALSE.

down

nick at NOSPAM dot ogredata dot com ¶

5 years ago

This function returns the value for the process PHP is executing under.

/var/somebody/files was only executable by owner (700).

It contained world-readable files, but without execute permission, PHP could not access the directory to download the files.

is_executable() returned false.

Making the dir world-executable (701) gave access to PHP.  The download worked. And is_executable() returned true.

I assume that if I added PHP to the group of the folder and gave the group executable permission, that would also work.

down

-1

Anonymous ¶

4 years ago

Under windows, it seems to returns always false for directories.

I.e

<?php
$dir = __DIR__;
$result = is_executable($dir) ? 'true' : 'false';

if($result){
  echo $result;
}
?>

So do NOT use this to check if a folder is transversable because it will be system dependant code.

down

-2

telezhkin at gmail dot com ¶

5 years ago

Find no mention of this, but is_executable returns result for owner permissions only (not for group or other).

＋添加备注

官方地址：https://www.php.net/manual/en/function.is-executable.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试数据库网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法正则表达式 Redis 互联网 MySql 软件运维 JavaScript 国际架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR MongoDB 运营 Python MemCache 商业硬件电子娱乐设计摄影 nginx WordPress 游戏 HTTP 团建数码电器 Docker

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦利用php soap实现web service ADOConnection 公用函数 adodb连接mysql多个数据库的问题 mysql面试题 PHP注释规范 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP7添加redis扩展 php上周一、本周一、下周一日期

略微加速

PHP官方手册 - 互联网笔记

is_executable

说明

参数

返回值

错误／异常

示例

注释

参见

发现了问题？

用户贡献的备注 5 notes