array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.readfile.php', 1 => 'readfile', 2 => 'Muestra un fichero', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.popen.php', 1 => 'popen', ), 'next' => array ( 0 => 'function.readlink.php', 1 => 'readlink', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/readfile.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

readfile

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

readfile — Muestra un fichero

Descripción

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

Lee un fichero y lo envía al buffer de salida.

Parámetros

filename

El fichero a leer.

use_include_path

Puede utilizarse el segundo argumento opcional para explorar el directorio include_path, pasando el valor de true.

context

Un resource de contexto de flujo.

Valores devueltos

Devuelve el número de bytes leídos desde el fichero en caso de éxito, o false si ocurre un error

Errores/Excepciones

En caso de fallo, se emitirá una advertencia de tipo E_WARNING.

Ejemplos

Ejemplo #1 Forzar la descarga utilizando 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;
}
?>

Resultado del ejemplo anterior es similar a:

Ventana de apertura / guardado

Notas

Nota:

readfile() no presentará problemas de memoria, incluso al enviar ficheros grandes. Si se encuentran este tipo de problemas, asegúrese de que el buffer de salida está desactivado con la función ob_get_level().

Sugerencia

Puede utilizar una URL como nombre de archivo con esta función, si el gestor fopen ha sido activado. Véase fopen() para más detalles sobre cómo especificar el nombre del archivo. Consulte Protocolos y Envolturas soportados para más información sobre las capacidades de los diferentes gestores, las notas sobre su uso, así como la información sobre las variables predefinidas que proporcionan.

Ver también