PHP fopen() : ouvrir, lire et écrire des fichiers (modes)

fopen('data.txt', 'r') ouvre un fichier et renvoie une poignée, une ressource de flux que les autres fonctions de fichier prennent en premier argument. Lisez avec fgets() (une ligne) ou fread() (un nombre d'octets), écrivez avec fwrite(), et fermez avec fclose(). Le second argument est le mode : 'r' pour lire, 'w' pour écrire, 'a' pour ajouter à la fin.

<?php
$fh = fopen('fruits.txt', 'w');          // create or empty the file
fwrite($fh, "apple\n");
fwrite($fh, "banana\n");
fwrite($fh, "cherry\n");
fclose($fh);

$fh = fopen('fruits.txt', 'r');
if ($fh === false) {
    exit("Cannot open fruits.txt\n");
}

while (($line = fgets($fh)) !== false) {
    echo 'Got: ', rtrim($line), "\n";
}
fclose($fh);

Sortie :

Got: apple
Got: banana
Got: cherry

fopen() renvoie false quand elle ne peut pas ouvrir le fichier (il n'existe pas en mode r, un dossier manque, pas de permission), et PHP affiche un warning comme :

Warning: fopen(missing.txt): Failed to open stream: No such file or directory in /home/index.php on line 2

Vérifiez donc false avant d'utiliser la poignée. Pour lire ou écrire un petit fichier entier en un appel, file_get_contents() et file_put_contents() sont plus courtes ; fopen() sert aux fichiers que vous lisez morceau par morceau ou gardez ouverts.

Les modes de fopen

Deux lignes surprennent. r+ écrit par-dessus les octets existants, sans insérer, et a+ écrit toujours à la fin, même après avoir déplacé le pointeur avec fseek() (le déplacer n'affecte que les lectures) :

<?php
file_put_contents('letters.txt', "abc\n");

$fh = fopen('letters.txt', 'r+');
fwrite($fh, 'X');                  // overwrites the "a"
fclose($fh);
echo file_get_contents('letters.txt');

$fh = fopen('letters.txt', 'a+');
fseek($fh, 0);                     // back to the start...
fwrite($fh, "end\n");              // ...but the write still goes to the end
rewind($fh);
echo fgets($fh);                   // reads do start at the beginning
fclose($fh);
echo file_get_contents('letters.txt');

Sortie :

Xbc
Xbc
Xbc
end

Sous Windows, vous verrez peut-être 'rb' ou 'wb' : l'option b signifie binaire et empêche Windows de convertir les fins de ligne. Elle ne fait rien sous Linux et macOS, l'ajouter est donc sans risque et portable.

Lire un fichier ligne par ligne avec fgets()

fgets() renvoie la ligne suivante, \n compris, et false à la fin du fichier. Comme une seule ligne est en mémoire à la fois, cette boucle gère un fichier de journal de n'importe quelle taille, et vous pouvez vous arrêter tôt avec break :

<?php
file_put_contents('app.log', <<<LOG
2026-03-14 09:00:01 INFO  server started
2026-03-14 09:00:05 ERROR database timeout
2026-03-14 09:01:12 INFO  request /home
2026-03-14 09:02:40 ERROR disk full
2026-03-14 09:03:00 INFO  request /about
LOG);

$fh = fopen('app.log', 'r');
$number = 0;
$errors = [];

while (($line = fgets($fh)) !== false) {
    $number++;
    if (str_contains($line, 'ERROR')) {
        $errors[] = "line $number: " . trim(substr($line, 26));
    }
}
fclose($fh);

echo count($errors), " errors in $number lines\n";
echo implode("\n", $errors), "\n";

Sortie :

2 errors in 5 lines
line 2: database timeout
line 4: disk full

Comparez à false avec !==, pas avec un simple while ($line = fgets($fh)) : une ligne contenant seulement "0" sans saut de ligne (la dernière ligne d'un fichier peut l'être) est évaluée à faux et terminerait la boucle trop tôt.

Écrire et ajouter avec fwrite()

fwrite() écrit une chaîne à la position courante et renvoie le nombre d'octets écrits, ou false en cas d'échec. fputs() est la même fonction sous un autre nom. Ouvrez avec 'a' pour ajouter à la fin d'un fichier sans toucher à son contenu :

<?php
$fh = fopen('visits.log', 'a');
foreach (['/home', '/about', '/contact'] as $page) {
    $bytes = fwrite($fh, "visit $page" . PHP_EOL);
    echo "wrote $bytes bytes\n";
}
fclose($fh);

$fh = fopen('visits.log', 'a');      // open again: the old lines stay
fwrite($fh, 'visit /home' . PHP_EOL);
fclose($fh);

echo file_get_contents('visits.log');

Sortie :

wrote 12 bytes
wrote 13 bytes
wrote 15 bytes
visit /home
visit /about
visit /contact
visit /home

PHP_EOL est la fin de ligne du système sur lequel tourne PHP (\n sous Linux et macOS, \r\n sous Windows). Pour des fichiers lus par d'autres programmes, choisissez-en une explicitement, en général "\n".

Lire et écrire des fichiers CSV avec fgetcsv() et fputcsv()

fputcsv() écrit un tableau comme une ligne CSV et met entre guillemets les champs qui contiennent des virgules, des guillemets ou des sauts de ligne. fgetcsv() relit une ligne sous forme de tableau. Passez explicitement le séparateur, le caractère d'encadrement et un caractère d'échappement vide : cela donne du CSV standard, et PHP 8.4 affiche un avis de dépréciation quand l'argument d'échappement est omis.

<?php
$rows = [
    ['name', 'city', 'note'],
    ['Ada', 'London', 'likes "math", a lot'],
    ['Linus', 'Helsinki', 'kernel'],
];

$fh = fopen('people.csv', 'w');
foreach ($rows as $row) {
    fputcsv($fh, $row, ',', '"', '');
}
fclose($fh);
echo file_get_contents('people.csv'), "\n";

// Read it back, using the first row as keys
$fh = fopen('people.csv', 'r');
$header = fgetcsv($fh, null, ',', '"', '');
while (($fields = fgetcsv($fh, null, ',', '"', '')) !== false) {
    $person = array_combine($header, $fields);
    echo "{$person['name']} lives in {$person['city']}: {$person['note']}\n";
}
fclose($fh);

Sortie :

name,city,note
Ada,London,"likes ""math"", a lot"
Linus,Helsinki,kernel

Ada lives in London: likes "math", a lot
Linus lives in Helsinki: kernel

Découper les lignes avec explode(',', $line) casse dès qu'un champ contient une virgule ; fgetcsv() gère les guillemets pour vous. Pour un fichier séparé par des points-virgules (courant dans les exports Excel en Europe), passez ';' comme séparateur.

Se déplacer dans un fichier avec fseek(), ftell() et rewind()

Un fichier ouvert a une position. Les lectures et écritures commencent là et l'avancent. ftell() indique où elle se trouve, fseek() la déplace à une position en octets, et rewind() revient au début. Avec w+, vous pouvez écrire un fichier et le relire par la même poignée :

<?php
$fh = fopen('message.txt', 'w+');
fwrite($fh, 'hello world');
echo ftell($fh), "\n";             // after the last byte written

fseek($fh, 6);
echo fread($fh, 5), "\n";          // 5 bytes from offset 6

rewind($fh);
echo stream_get_contents($fh), "\n";  // everything from the position to the end
fclose($fh);

Sortie :

11
world
hello world

Verrouiller un fichier avec flock()

Deux requêtes qui lisent un compteur, ajoutent un et le réécrivent en même temps peuvent toutes deux lire 41 et toutes deux écrire 42. flock() avec LOCK_EX fait attendre la seconde jusqu'à ce que la première libère le verrou. Le mode c+ est le bon ici : il crée le fichier si nécessaire et, contrairement à w+, ne le vide pas avant que vous teniez le verrou.

<?php
function increment(string $path): int
{
    $fh = fopen($path, 'c+');
    flock($fh, LOCK_EX);               // wait for exclusive access

    $count = (int) stream_get_contents($fh);
    $count++;

    ftruncate($fh, 0);                 // empty the file
    rewind($fh);
    fwrite($fh, (string) $count);
    fflush($fh);

    flock($fh, LOCK_UN);
    fclose($fh);
    return $count;
}

for ($i = 0; $i < 3; $i++) {
    echo 'Visitor number ', increment('counter.txt'), "\n";
}

Sortie :

Visitor number 1
Visitor number 2
Visitor number 3

Les verrous sont consultatifs : ils n'arrêtent que l'autre code qui appelle aussi flock(). Pour ajouter une ligne, file_put_contents($path, $line, FILE_APPEND | LOCK_EX) fait la même chose en un appel.

Erreur fréquente : while (!feof($fh))

Beaucoup d'anciens tutoriels bouclent avec feof(). Elle ne renvoie true qu'après qu'une lecture a déjà atteint la fin, donc la boucle tourne une fois de plus qu'il n'y a de lignes et le dernier fgets() renvoie false :

<?php
file_put_contents('abc.txt', "a\nb\nc\n");

$fh = fopen('abc.txt', 'r');
$rounds = 0;
while (!feof($fh)) {
    $line = fgets($fh);
    $rounds++;
    var_dump($line);
}
fclose($fh);
echo "$rounds rounds for 3 lines\n";

Sortie :

string(2) "a
"
string(2) "b
"
string(2) "c
"
bool(false)
4 rounds for 3 lines

Ce false en trop devient une ligne vide dans un rapport ou un élément vide dans un tableau. Bouclez sur la lecture elle-même, while (($line = fgets($fh)) !== false), comme le font tous les autres exemples de cette page.