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.