file
(PHP 4, PHP 5)
file — Načíta obsah súboru do poľa
Popis
Táto funkcia je identická s funkciou readfile(), avšak file() vráti obsah načítaného súboru ako pole. Každý prvok poľa zodpovedá jednému riadku v súbore, pričom obsahuje aj znak konca riadku. Pri chybe vráti funkcia file() FALSE.
Note: Každý riadok vo výslednom poli bude obsahovať znak konca riadka, čiže ak konce riadkov nie sú žiadúce, treba na ich odstránenie použiť funkciu trim().
Note: Ak máte problémy s tým, že PHP nerozpoznáva konce riadkov pri čítaní súborov na počítači Macintosh alebo na ňom vytvorených, možno budete chcieť povoliť run-time konfiguračnú voľbu auto_detect_line_endings.
Voliteľný parameter pouzivat_cesty_include je vhodné použiť a nastaviť na hodnotu, ak chcete hľadať požadovaný súbor aj v ceste include_path.
<?php
// Načíta obsah súboru do poľa. V tomto prípade použijeme protokol HTTP na
// načítanie HTML zdroja zadaného pomocou URL.
$lines = file ('https://www.adresa.com/');
// Iterujme naše pole, zobrazme HTML zdroj ako HTML zdroj a pridajme naviac
// čísla riadkov.
foreach ($lines as $line_num => $line) {
echo "Riadok č. <b>{$line_num}</b> : " . htmlspecialchars($line) . "<br>\n";
}
// Ďalší príklad - načítajme internetovú stránku do reťazca. Pozri tiež file_get_contents().
$html = implode ('', file ('https://www.adresa.com/'));
?>
Note: Od verzie PHP 4.3.0 môžete používať funkciu file_get_contents() na načítanie obsahu súboru do reťazca.
Od PHP 4.3.0 pracuje funkcia file() správne aj s binárnymi súbormi.
Môžete použiť URL ako názov súboru s touto funkciou ak boli fopen wrappery povolené. Pozri fopen() pre viac detailov ako určiť názov súboru a Zoznam Podporovaných Protokolov/Balíčkov pre zoznam podporovaných URL protokolov.
Pozri tiež readfile(), fopen(), fsockopen(), popen(), file_get_contents() a include().