is_executable

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

is_executablePrüft, ob der Dateiname ausführbar ist

Beschreibung

is_executable(string $filename): bool

Prüft, ob der Dateiname ausführbar ist.

Parameter-Liste

filename

Der Pfad zur Datei.

Rückgabewerte

Gibt true zurück, wenn der Dateiname existiert und ausführbar ist, oder false im Fehlerfall. Auf POSIX-Systemen ist eine Datei ausführbar, wenn in den Dateiberechtigungen das Ausführungsbit gesetzt ist. Für Windows siehe den Hinweis unten.

Fehler/Exceptions

Im Fehlerfall wird eine E_WARNING ausgegeben.

Beispiele

Beispiel #1 is_executable()-Beispiel

<?php

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

if (
is_executable($file)) {
echo
$file.' ist ausführbar';
} else {
echo
$file.' ist nicht ausführbar';
}

?>

Anmerkungen

Hinweis: Die Ergebnisse dieser Funktion werden zwischengespeichert. Weitere Details sind bei clearstatcache() zu finden.

Tipp

Seit PHP 5.0.0 kann diese Funktion mit einigen URL-Wrappern benutzt werden. Schauen Sie in der Liste unter Unterstützte Protokolle und Wrapper nach, welcher Wrapper die Funktionalität von stat() unterstützt.

Hinweis: Unter Windows gilt eine Datei als ausführbar, wenn es sich laut der Win-API GetBinaryType() um eine ordnungsgemäß ausführbare Datei handelt; aus Gründen der Abwärtskompatibilität gelten auch Dateien mit der Erweiterung .bat oder .cmd als ausführbar. Vor PHP 7.4.0 wurde jede nicht-leere Datei mit der Erweiterung .exe oder .com als ausführbar angesehen. Zu beachten ist, dass PATHEXT für is_executable() irrelevant ist.

Siehe auch

  • is_file() - Prüft, ob der Dateiname eine reguläre Datei ist
  • is_link() - Prüft, ob der Dateiname ein symbolischer Link ist

add a note add a note

User Contributed Notes 5 notes

up
12
Shyammakwana.me
7 years ago
For windows users,

It will return TRUE for EXE extensions. I have checked for MSI, but it returns FALSE.
up
2
nick at NOSPAM dot ogredata dot com
4 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.
up
1
Anonymous
3 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.
up
1
divinity76 at gmail dot com
4 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;
}
up
-1
telezhkin at gmail dot com
4 years ago
Find no mention of this, but is_executable returns result for owner permissions only (not for group or other).
To Top