is_executable

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

    is_executable — Diz 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

    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.

    Dica

    A partir do PHP 5.0.0, esta função também pode ser usada com alguns wrappers URL. Consulte os Protocolos e Wrappers suportados para determinar quais wrappers 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
    To Top