PHP kézikönyv
Előző |  | Következő

# file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- Reads entire file into a string

## Leírás

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.

> Megjegyzés: If you're opening a URI with special characters, such as spaces, you need to encode the URI with urlencode().

> Megjegyzés: context parameter can be skipped by `NULL`.

## Változások naplója

Változat | Leírás
--- | ---
5.0.0 | Added the context support.
5.1.0 | Added the offset and maxlen parameters.

## Megjegyzések

> Megjegyzés: Ez a függvény "binary-safe", azaz helyesen kezeli a 127-es ASCII kód feletti karaktereket is.

> Tipp: URL-t is megadhatsz az állomány név paraméter helyén ha a fopen wrappers szolgáltatás be van kapcsolva. Bővebb információk az fopen() leírásánál olvashatóak arról, milyen módon adhatod meg a fájlneveket, valamint érdemes megtekinteni a M Függelék oldalt a támogatott URL típusok listájának megtekintése gyanánt.

> Megjegyzés: A context támogatása a PHP 5.0.0 változattól felfele érhető el. A conext-ek leírását itt találod: CL, Stream Functions Referencia .

Figyelem
SSL titkosított kapcsolat esetén a Microsoft IIS webszerver az SSL protokol helytelen implementálása folytán a kapcsolatot a close_notify jelzése nélkül zárja. A PHP ezt a következő hibaüzenettel honorálja, amikor az adattovábbítás végére ér: "SSL: Fatal Protocol Error". A probléma tüneti kezelésére a error_reporting beállítást lehet lejjebb venni. APHP 4.3.7-es és későbbi változatai képesek felismerni a hibásan működő IIS szerver-szoftvert amikor a https:// adatfolyam-burkolót alkalmazod és elnyeli a fenti hibaüzeneteket. Ha az fsockopen()-t használod ssl:// csatornán keresztül, a hibaüzenetet magad tudod észlelni és elnyomni.

## Lásd még

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

Előző | Tartalom | Következő
file_exists | Fel | file_put_contents