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áltozatLeí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: CLIII, 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()
stream_context_create()