fpassthru

(PHP 4, PHP 5)

fpassthruAffiche le reste du fichier

Description

int fpassthru ( resource $handle )

Lit tout le reste d'un fichier jusqu'� la fin et dirige le r�sultat vers la sortie standard.

Vous devez appeler la fonction rewind() pour r�initialiser le pointeur de fichier au d�but si vous avez d�j� �crit des donn�es dans le fichier.

Si vous voulez uniquement copier le contenu d'un fichier dans le buffer de sortie, sans le modifier auparavant ou placer le pointeur � un endroit particulier, vous devriez utiliser la fonction readfile(), ce qui vous �vite d'appeler la fonction fopen() call.

Liste de param�tres

handle

Le pointeur de fichier doit �tre valide et pointer sur un fichier ouvert avec succ�s par fopen() ou fsockopen() (et pas encore ferm� par fclose()).

Valeurs de retour

Si une erreur survient, fpassthru() retourne FALSE. Sinon, fpassthru() retourne le nombre de caract�res lus dans handle et pass�s � la sortie standard.

Exemples

Exemple #1 Utilisation de fpassthru() avec un fichier binaire

<?php

// ouvre un fichier en mode binaire
$name './img/ok.png';
$fp fopen($name'rb');

// envoie les bons en-t�tes
header("Content-Type: image/png");
header("Content-Length: " filesize($name));

// envoie le contenu du fichier, puis stoppe le script
fpassthru($fp);
exit;

?>

Notes

Note: Lorsque vous utilisez la fonction fpassthru() sur un fichier binaire sous Windows, assurez-vous d'avoir ouvert le fichier en mode binaire en ajoutant la lettre b au mode d'acc�s utilis� dans fopen().
Vous �tes encourag� � utiliser l'option b lorsque vous traitez des fichiers binaires, m�me si votre syst�me ne le requiert pas, de fa�on � rendre vos scripts portables.

Voir aussi

  • readfile() - Affiche un fichier
  • fopen() - Ouvre un fichier ou une URL
  • popen() - Cr�e un processus de pointeur de fichier
  • fsockopen() - Ouvre une socket de connexion Internet ou Unix