file_put_contents
fileatime
Fonctions sur les systèmes de fichiers
PHP Manual

# file

(PHP 4, PHP 5)

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

### Description

array file ( string `$filename` [, int `$flags`= 0 [, resource `$context` ]] )

Lit le fichier et renvoie le résultat dans un tableau.

> Note: Vous pouvez utiliser la fonction file_get_contents() pour retourner le contenu d'un fichier dans une chaîne de caractères.

### Liste de paramètres

`filename`

  Chemin vers le fichier.

  Astuce

  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activée. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier et Liste des protocoles supportés pour une liste des protocoles URL supportés.

`flags`

  Le paramètre optionnel `flags` peut être une ou plusieurs des constantes suivantes :

  `FILE_USE_INCLUDE_PATH`
    Recherche le fichier dans l'include_path.
  `FILE_IGNORE_NEW_LINES`
    N'ajoute pas de nouvelle ligne à la fin de chaque élément du tableau.
  `FILE_SKIP_EMPTY_LINES`
    Ignore les lignes vides.
  `FILE_TEXT`
    Le contenu est retourné en utilisant l'encodage UTF-8. Vous pouvez spécifier un encodage différent en créant un contexte personnalisé. Ce drapeau ne peut être utilisé avec le drapeau `FILE_BINARY`.
  `FILE_BINARY`
    Le contenu est lu en tant que données binaires. C'est le comportement par défaut et ne peut être utilisé avec le drapeau `FILE_TEXT`.

`context`

  Une ressource de contexte valide, créée avec la fonction stream_context_create().

  > Note: Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contextes, référez-vous à Fonctions sur les flux.

### Valeurs de retour

Retourne le fichier dans un tableau. Chaque élément du tableau correspond à une ligne du fichier, et les retours-chariot sont placés en fin de ligne. Si une erreur survient, file() retournera `FALSE`.

> Note: Chaque ligne du tableau résultant inclura la fin de ligne, tant que `FILE_IGNORE_NEW_LINES` est utilisé, donc, vous avez toujours besoin d'utiliser la fonction rtrim() si vous ne voulez pas de fin de lignes.

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

### Historique

Version | Description
--- | ---

6.0.0

Ajout du support des drapeaux `FILE_TEXT` et `FILE_BINARY`.

> Note: Pour des raisons de compatibilités ascendantes, ces constantes sont disponibles depuis PHP 5.2.7

5.0.0 | Le paramètre `context` a été ajouté.
5.0.0 | Avant PHP 5.0.0, le paramètre`flags` ne couvre que l'include_path et est activé s'il vaut 1.
4.3.0 | file() devient compatible avec les données binaires.

### Exemples

Exemple #1 Exemple avec file()

`<?php
// Lit une page web dans un tableau.
$lines = file('http://www.example.com/');
// Affiche toutes les lignes du tableau comme code HTML, avec les numéros de ligne
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// Un autre exemple, pour obtenir une page web dans une chaîne. Voir aussi la fonction file_get_contents().
$html = implode('', file('http://www.example.com/'));
// Utilisation de drapeau, depuis PHP 5
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>`

### Notes

Avertissement

Lorsque vous utilisez SSL, le serveur IIS de Microsoft violera le protocole en fermant la connexion sans envoyer l'indicateur close_notify. PHP le reportera en tant que "SSL: Fatal Protocol Error" quand vous arrivez à la fin des données. L'astuce est de baisser le niveau de la directive error_reporting pour ne pas inclure les alertes. À partir de PHP 4.3.7, le bogue est détecté automatiquement lors de l'ouverture du flux en utilisant https:// et supprimera cet avertissement pour vous. Si vous utilisez fsockopen() pour créer une socket ssl://, vous devez vous occuper vous-même de supprimer l'erreur.

### Voir aussi

- readfile() - Affiche un fichier
- fopen() - Ouvre un fichier ou une URL
- fsockopen() - Ouvre une socket de connexion Internet ou Unix
- popen() - Crée un processus de pointeur de fichier
- file_get_contents() - Lit tout un fichier dans une chaîne
- include() - include
- stream_context_create() - Crée un contexte de flux

file_put_contents
fileatime
Fonctions sur les systèmes de fichiers
PHP Manual