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
readfile(
string $filename,
bool $use_include_path = false,
?resource $context = null
): int|false
Exemplo
Vamos exibir o conteúdo de um arquivo de texto:
<?php
$res = readfile('example.txt');
echo "bytes lidos: " . $res;
?>
Exemplo
Vamos tentar ler um arquivo que não existe:
<?php
$res = readfile('nonexistent.txt');
if ($res === false) {
echo "Falha ao ler o arquivo";
}
?>
Exemplo
Uso do flag include_path:
<?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