is_executable

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

is_executableDiz se um arquivo é executável

Descrição

is_executable(string $filename): bool

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.

Tip

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().

Veja Também

  • is_file() - Informa se o arquivo é um arquivo comum
  • is_link() - Informa se o arquivo é uma ligação simbólica