file_get_contents
(PHP 4 >= 4.3.0, PHP 5)
file_get_contents — Egy egész fájlt beolvas karakterláncba
Leírás
Azonos a file() függvénnyel, kivéve, hogy a file_get_contents() függvény a fájlt összefüggő karakterláncként adja vissza, ami az offset paraméterben megadott ponttól mért maxlen paraméterben megadott bájtnyi részt tartalmazza a fájlból. Sikertelenség esetén a file_get_contents() függvény FALSE-szal tér vissza.
A file_get_contents() függvény az előnyben részesített függvény fájlok tartalmának karakterláncba olvasásakor. Ez memórianyilvántartási technikákat használ a teljesítmény fokozásáért, ha ezt támogatja az operációs rendszered.
Note: Ha különleges karaktereket (pl.: szóköz) tartalmazó URI-t nyitsz meg, ezt kódolnod kell az urlencode() függvénnyel.
Note: A context paraméter NULL értékkel kihagyható.
Változások naplója
| Változat | Leírás |
|---|---|
| 5.0.0 | Szövegkörnyezet-támogatás hozzáadása |
| 5.1.0 | Az offset és maxlen paraméterek hozzáadása. |
Megjegyzések
Note: Ez a függvény "binary-safe", azaz helyesen kezeli a 127-es ASCII kód feletti karaktereket is.
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 List of Supported Protocols/Wrappers oldalt a támogatott URL típusok listájának megtekintése gyanánt.
Note: 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: Streams.
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.