Função readfile

A função readfile lê um arquivo e imediatamente envia seu conteúdo para o buffer de saída. Ela retorna o número de bytes lidos ou false em caso de erro. O primeiro parâmetro é o caminho para o arquivo, o segundo (opcional) é um flag para buscar o arquivo no include_path, o terceiro (opcional) é o contexto de fluxo.

Sintaxe

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

Exemplo

Vamos exibir o conteúdo de um arquivo de texto:

php<?php
  $res = readfile('example.txt');
  echo "bytes lidos: " . $res;
?>

Exemplo

Vamos tentar ler um arquivo que não existe:

php<?php
  $res = readfile('nonexistent.txt');
  
  if ($res === false) {
    echo "Falha ao ler o arquivo";
  }
?>

Exemplo

Uso do flag include_path:

php<?php
  $res = readfile('config.ini', true);
  echo $res !== false ? "Leitura bem-sucedida" : "Falha na leitura";
?>

Veja também

  • a função file_get_contents,
    que lê um arquivo para uma string
  • a função fpassthru,
    que exibe o restante de um arquivo
  • a função file,
    que lê um arquivo para um array