Podręcznik PHP
Poprzedni |  | Następny

# fread

(PHP 3, PHP 4, PHP 5)

fread -- Odczyt pliku binarnie bezpieczy

## Opis

string fread ( resource uchwyt, int długość )

fread() odczytuje do długość bajtów ze wskaźnika pliku określonego przez uchwyt. Czytanie kończy się gdy odczytano długość bajtów, osiągnięty został koniec pliku (EOF), (dla sieciowych strumieni), kiedy pakiet stanie się dostępny lub (po otwarciu strumienia z przestrzeni użytkownika) kiedy 8192 bajtów zostanie odczytanych, cokolwiek nastąpi pierwsze.

Zwraca łańcuch znaków lub `FALSE` w przypadku błędu.

`<?php // pobierz zawartość pliku do łańcucha $nazwa_pliku = "/usr/local/jakis.txt"; $uchwyt = fopen($nazwa_pliku, "r"); $tresc = fread($uchwyt, filesize($nazwa_pliku)); fclose($uchwyt); ?>`

Ostrzeżenie
W systemach, które rozróżniają pliki binarne i tekstowe (np. Windows) plik musi zostać otworzony z 'b' dołączonym do parametru tryb fopen().

`<?php $nazwa_pliku = "c:\\pliki\\jakisobrazek.gif"; $uchwyt = fopen($nazwa_pliku, "rb"); $tresc = fread($uchwyt, filesize($nazwa_pliku)); fclose($uchwyt); ?>`

Ostrzeżenie
Kiedy następuje odczyt z czegokolwiek innego niż zwykłe lokalne pliki, takich jak strumienie zwrócone gdy odczytujesz zdalne pliki lub z popen() i fsockopen(), odczyt zakończy się po tym jak pakiet jest dostępny. To znaczy, że powinieneś gromadzić dane razem z kawałków jak pokazano na poniższych przykładach.

`<?php // dla PHP 5 i nowszych $uchwyt = fopen("http://www.example.com/", "rb"); $tresc = stream_get_contents($uchwyt); fclose($uchwyt); ?>`

`<?php $uchwyt = fopen("http://www.przykladowy.com/", "rb"); $tresc = ''; while (!feof($uchwyt)) { $tresc .= fread($uchwyt, 8192); } fclose($uchwyt); ?>`

> Notatka: Jeśli po prostu chcesz otrzymać treść pliku w stringu, użyj file_get_contents() dlatego, że ma to dużo lepszą wydajność niż kod powyżej.

Patrz także: fwrite(), fopen(), fsockopen(), popen(), fgets(), fgetss(), fscanf(), file() i fpassthru().

Poprzedni | Spis treści | Następny
fputs | Początek rozdziału | fscanf