file

(PHP 3, PHP 4 )

file --  Lit le fichier et renvoie le résultat dans un tableau

Description

array file ( string filename [, int use_include_path [, resource context]])

file() est identique à readfile(), hormis le fait que file() retourne le fichier dans un tableau. Chaque élément du tableau correspond à une ligne du fichier, et les retour-chariots sont placés en fin de ligne.

Note : Chaque élément du tableau résultat contiendra la nouvelle ligne de fin de chaîne. Il faudra donc utiliser rtrim() sur cette valeur pour la supprimer.

Note : Si vous avez des problèmes avec PHP qui ne reconnait pas certaines lignes lors de la lecture de fichier qui ont été créé ou lus sur un MacIntosh, vous pouvez activer l'option de configuration auto_detect_line_endings.

Vous pouvez utiliser l'option use_include_path : en la mettant à "1", vous rechercherez aussi dans le dossier include_path.

Exemple 1. Exemple avec file()

<?php
// Lit une page web dans un tableau.
$lines = file ('http://www.exemple.com/');

// Affiche toutes les lignes du tableau comme code HTML, avec les num&eacute;ros de ligne
foreach ($lines as $line_num => $line) {
    echo
"Ligne No <b>$line_num</b> : " . htmlspecialchars($line) . "<br>\n";
}

// Un autre exemple, pour obtenir une page web dans une cha&icirc;ne. Voir aussi la fonction file_get_contents().
$html = implode ('', file ('http://www.exemple.com/'));
?>

Note : Depuis PHP 4.3.0, vous pouvez utiliser file_get_contents() pour lire le contenu d'un fichier dans une chaîne.

En PHP 4.3.0, file() est désormais compatible avec les données binaires.

Tuyau : Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si l'option des "fopen wrappers" a été activée. Voyez fopen() pour plus de détails.

Voir aussi readfile(), fopen(), fsockopen(), popen(), file_get_contents() et include().