is_executable
(PHP 4, PHP 5, PHP 7, PHP 8)
is_executable — Diz se um arquivo é executável
Parâmetros
filename
-
Caminho para o arquivo.
Valor Retornado
Retorna true
se o arquivo existe e é executável, ou false
em
caso de erro. Em sistemas POSIX, um arquivo é executável se o bit de executável
das permissões de arquivo estiver ligado. Para Windows, veja a nota abaixo.
Erros/Exceções
Em caso de falha, um E_WARNING
será emitido.
Exemplos
Example #1 Exemplo da is_executable()
<?php
$file = '/home/vincent/arquivo.sh';
if (is_executable($file)) {
echo $file.' é executável';
} else {
echo $file.' não é executável';
}
?>
Notas
Note: Os resultados desta função são armazenados em cache. Consulte a função clearstatcache() para mais detalhes.
A partir do PHP 5.0.0, esta função também pode ser usada com alguns wrappers URL. Consulte os Protocolos e empacotadores suportados para determinar quais wrappers suportam a família de funções stat().
Note: No Windows, um arquivo é considerado executável se for assim reportado pela função
GetBinaryType()
da API do Windows; por razões de compatibilidade, arquivos com extensões .bat ou .cmd também são considerados executáveis. Antes do PHP 7.4.0, qualquer arquivo não vazio com extensão .exe ou .com era considerado executável. Note que PATHEXT é irrelevante para a função is_executable().