readfile

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

    readfile — Exibe o conteúdo de um arquivo

    Descrição

    readfile(string$filename, bool$use_include_path = false, ?resource$context = null): int|false

    Lê um arquivo e escreve o seu conteúdo para o buffer de saída.

    Parâmetros

    filename

    O nome do arquivo a ser lido.

    use_include_path

    Pode-se usar o segundo parâmetro opcional e configurá-lo para true, se for desejado procurar o arquivo no include_path também.

    context

    Um resource de contexto de stream.

    Valor Retornado

    Retorna o número de bytes lidos do arquivo em caso de sucesso, ou false em caso de falha

    Erros/Exceções

    Em caso de falha, um E_WARNING será emitido.

    Exemplos

    Exemplo #1 Forçando um recebimento usando readfile()

    <?php
    $file     = 'monkey.gif';

    if (    file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="'.basename($file).'"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    readfile($file);
    exit;
    }
    ?>

    O exemplo acima produzirá algo semelhante a:

    Diálogo de Abrir / Salvar

    Notas

    Nota:

    readfile() não apresentará por si só nenhum problema de memória, mesmo no envio de grandes arquivos. Se for encontrado um erro de falta de memória, certifique-se que o buffer de saída está desligado com ob_get_level().

    Dica

    Uma URL pode ser usada como um nome de arquivo com esta função se os wrappers fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e Wrappers suportados para obter links para informações sobre as capacidades de cada wrapper, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

    Veja Também

    To Top