Fonction file()

❮ Référence du système de fichiers PHP

Exemple

Lire un fichier dans un tableau :

<?php
print_r(file("test.txt"));
?>
Exécuter l'exemple »

Définition et utilisation

La fonction file() lit un fichier et le retourne sous forme de tableau.

Chaque élément du tableau contient une ligne du fichier, avec le caractère de nouvelle ligne toujours présent.

Syntaxe

file( filename , flag , context )

Valeurs des paramètres

Paramètre Description
filename Requis. Spécifie le chemin du fichier à lire.
flag Optionnel. Peut être une ou plusieurs des constantes suivantes :
  • FILE_USE_INCLUDE_PATH - Rechercher le fichier dans le include_path (dans php.ini)
  • FILE_IGNORE_NEW_LINES - Ignorer la nouvelle ligne à la fin de chaque élément du tableau
  • FILE_SKIP_EMPTY_LINES - Ignorer les lignes vides dans le fichier
  • FILE_NO_DEFAULT_CONTEXT - Ne pas utiliser le contexte par défaut
context Optionnel. Spécifie le contexte du gestionnaire de fichier. Le contexte est un ensemble d'options qui peuvent modifier le comportement d'un flux. Peut être omis en utilisant NULL.


Détails techniques

Valeur de retour : Le fichier entier sous forme de tableau, FALSE en cas d'échec.
Version PHP : 4.0+
Sûr pour les binaires : Oui
Journal des modifications : PHP 8.3 : Lance une ValuError si flag est une valeur invalide.

❮ Référence du système de fichiers PHP