file

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