PHP -> Funkcie -> Súborové funkcie PHP -> funkcia file
Syntax
array file ( string nazovsuboru [, int pouzivat_cesty_include] )
Popis
Príkaz jazyka PHP načíta obsah súboru do poľa.
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.
Poznámka: 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.
Poznámka: 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 by ste mali povoliť run-time konfiguračnú voľbu auto_detect_line_endings.
Poznámka: 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.
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.
Tip: 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 Dodatok L pre zoznam podporovaných URL protokolov.
Príklad
<?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 ('http://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 ('http://www.adresa.com/'));
?>
Pozri aj
readfile, fopen, fsockopen, popen, file_get_contents a include