file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- Reads entire file into a string

Beskrivelse

string file_get_contents ( string filename [, bool use_include_path [, resource context [, int offset [, int maxlen]]]] )

Identical to file(), except that file_get_contents() returns the file in a string, starting at the specified offset up to maxlen bytes. On failure, file_get_contents() will return FALSE.

file_get_contents() is the preferred way to read the contents of a file into a string. It will use memory mapping techniques if supported by your OS to enhance performance.

Bemærk: If you're opening a URI with special characters, such as spaces, you need to encode the URI with urlencode().

Bemærk: context parameter can be skipped by NULL.

ChangeLog

VersionBeskrivelse
5.0.0 Added the context support.
5.1.0 Added the offset and maxlen parameters.

Notes

Bemærk: Denne funktion er binary-safe.

Vink: Du kan bruge en URL som filnavn med denne funktion, hvis fopen wrappers er slået til. Se fopen() for flere detaljer omkring hvordan man udformer filnavnet og Appendiks N for en liste over understøttede URL-protokoller.

Bemærk: Kontekst understøttelse blev tilføjet i PHP 5.0.0.

Advarsel

Ved brug af SSL, vil Microsoft IIS overtræde protokollen, ved at lukke forbindelsen uden at sende en close_notify indikator. PHP vil reportere dette som "SSL: Fatal Protocol Error" når du når til slutningen af datastrømmen. For at undgå dette, bør du sænke din error_reporting, til ikke at inkludere advarsler. PHP 4.3.7 og højere kan opdage den fejlagtige IIS server software når du åbner en stream ved hjælp af https:// wrapperen og vil skjule advarslen for dig. Hvis du benytter fsockopen() til at lave et ssl:// socket, er du selv ansvarlig for at opdage og skjule advarslen.

Se også

file()
fgets()
fread()
readfile()
file_put_contents()
stream_get_contents()
stream_context_create()