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
Exemplo #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
Nota: Os resultados desta
função são armazenados em cache. Consulte a função clearstatcache() para
mais detalhes.
DicaA partir do PHP 5.0.0, esta função
também pode ser usada com alguns empacotadores de URL. Consulte os
Protocolos e empacotadores suportados para determinar quais empacotadores suportam
a família de funções stat().
Nota:
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().
Veja Também
- is_file() - Informa se o arquivo é um arquivo comum
- is_link() - Informa se o arquivo é uma ligação simbólica