fpassthru
(PHP 4, PHP 5)
fpassthru — Affiche le reste du fichier
Description
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