array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.readfile.php', 1 => 'readfile', 2 => 'Affiche un fichier', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Fonctions sur les systèmes de fichiers', ), 'prev' => array ( 0 => 'function.popen.php', 1 => 'popen', ), 'next' => array ( 0 => 'function.readlink.php', 1 => 'readlink', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', '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 — Affiche un fichier

Description

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

Lit un fichier et l'envoie dans le buffer de sortie.

Liste de paramètres

filename

Le fichier à lire.

use_include_path

Il est possible d'utiliser le deuxième paramètre optionnel pour explorer le dossier include_path, en passant la valeur de true.

context

Note: Une resource de contexte de flux.

Valeurs de retour

Retourne le nombre d'octets lus depuis le fichier en cas de succès, ou false si une erreur survient

Erreurs / Exceptions

En cas d'échec, une alerte de type E_WARNING sera émise.

Exemples

Exemple #1 Forcer le téléchargement en utilisant 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;
}
?>

Résultat de l'exemple ci-dessus est similaire à :

Fenêtre d'ouverture / de sauvegarde

Notes

Note:

readfile() ne présentera pas de problème mémoire, même lors de l'envoi de gros fichiers. En cas de ce type de problème, il faut s'assurer que la mise en mémoire tampon de la sortie est désactivée avec la fonction ob_get_level().

Astuce

Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activé. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux Liste des protocoles et des gestionnaires supportés pour plus d'informations sur les capacités des différents gestionnaires, les notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles fournissent.

Voir aussi