Funções para Sistema de arquivo
PHP Manual

fpassthru

(PHP 4, PHP 5)

fpassthruImprime todo os dados restantes de um ponteiro de arquivo

Descrição

int fpassthru ( resource $handle )

Lê até o fim do arquivo (EOF) do ponteiro de arquivo dado e imprime os resultados para a buffer de saída.

Se você precisa chamar rewind() para resetar o ponteiro do arquivo para início do arquivo se você já escreveu dados para o arquivo.

Se você somente quiser jogar o conteúdo de um arquivo para o buffer de saída, sem primeiro modificar ou procurar por um detalhe qualquer, você pode querer usar a função readfile(), que vai economizar uma chamada a função fopen().

Parâmetros

handle

The file pointer must be valid, and must point to a file successfully opened by fopen() or fsockopen() (and not yet closed by fclose()).

Valor Retornado

Se um error ocorrer, a função fpassthru() retorna FALSE. No sucesso, fpassthru() retorna o número de caracteres lidos do handle e passado para a exibição.

Exemplos

Exemplo #1 Usando fpassthru() com arquivo binário

<?php

// abre o arquivo em modo binário
$name './img/ok.png';
$fp fopen($name'rb');

// envia os headers
header("Content-Type: image/png");
header("Content-Length: ".filesize($name));

// manda a imagem e pára o script
fpassthru($fp);
exit;

?>

Notas

Nota:

Quando utilizando fpassthru() em um arquivo binário em sistemas Windows, você precisa verificar se abriu o arquivo em modo binário, acrescentando um b no modo informado na chamada de fopen().

Você é encorajado a utilizar o modo b quando trabalhando com arquivos binários, mesmo que seu sistema não requira isso, de forma que seus scripts se tornem mais portáveis.

Veja Também


Funções para Sistema de arquivo
PHP Manual