PHP fopen(): aprire, leggere e scrivere file (le modalità)

fopen('data.txt', 'r') apre un file e restituisce un handle, una risorsa stream che le altre funzioni sui file accettano come primo argomento. Leggi con fgets() (una riga) o fread() (un certo numero di byte), scrivi con fwrite() e chiudi con fclose(). Il secondo argomento è la modalità: 'r' per leggere, 'w' per scrivere, 'a' per aggiungere in fondo.

<?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);

Output:

Got: apple
Got: banana
Got: cherry

fopen() restituisce false quando non riesce ad aprire il file (non esiste in modalità r, manca una cartella, mancano i permessi), e PHP stampa un warning come:

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

Quindi verifica false prima di usare l'handle. Per leggere o scrivere un intero file piccolo in una sola chiamata, file_get_contents() e file_put_contents() sono più brevi; fopen() serve per i file che leggi a pezzi o tieni aperti.

Modalità di fopen

Due righe sorprendono. r+ scrive sopra i byte esistenti sul posto, senza inserire, e a+ scrive sempre alla fine, anche dopo aver spostato il puntatore con fseek() (spostarlo influisce solo sulle letture):

<?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');

Output:

Xbc
Xbc
Xbc
end

Su Windows potresti vedere 'rb' o 'wb': il flag b significa binario e impedisce a Windows di tradurre i fine riga. Su Linux e macOS non fa nulla, quindi aggiungerlo è innocuo e portabile.

Leggere un file riga per riga con fgets()

fgets() restituisce la riga successiva compreso il suo \n, e false alla fine del file. Dato che in memoria c'è una sola riga alla volta, questo ciclo gestisce un file di log di qualsiasi dimensione, e puoi fermarti prima con 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";

Output:

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

Confronta con false usando !==, non con un semplice while ($line = fgets($fh)): una riga che contiene solo "0" senza a capo (l'ultima riga di un file può esserlo) è falsy e terminerebbe il ciclo in anticipo.

Scrivere e aggiungere con fwrite()

fwrite() scrive una stringa nella posizione corrente e restituisce il numero di byte scritti, oppure false in caso di errore. fputs() è la stessa funzione con un altro nome. Apri con 'a' per aggiungere in fondo a un file senza toccare ciò che c'è:

<?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');

Output:

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

PHP_EOL è il fine riga del sistema su cui gira PHP (\n su Linux e macOS, \r\n su Windows). Per i file letti da altri programmi, scegline uno esplicitamente, di solito "\n".

Leggere e scrivere file CSV con fgetcsv() e fputcsv()

fputcsv() scrive un array come una riga CSV e mette tra virgolette i campi che contengono virgole, virgolette o a capo. fgetcsv() rilegge una riga come array. Passa esplicitamente il separatore, il carattere di delimitazione e un carattere di escape vuoto: così ottieni un CSV standard, e PHP 8.4 stampa un avviso di deprecazione quando l'argomento di escape viene omesso.

<?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);

Output:

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

Dividere le righe con explode(',', $line) si rompe appena un campo contiene una virgola; fgetcsv() gestisce le virgolette per te. Per un file separato da punti e virgola (comune nelle esportazioni Excel in Europa), passa ';' come separatore.

Muoversi in un file con fseek(), ftell() e rewind()

Un file aperto ha una posizione. Letture e scritture partono da lì e la fanno avanzare. ftell() ti dice dove si trova, fseek() la sposta a un offset in byte, e rewind() torna all'inizio. Con w+ puoi scrivere un file e rileggerlo tramite lo stesso handle:

<?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);

Output:

11
world
hello world

Bloccare un file con flock()

Due richieste che leggono un contatore, aggiungono uno e lo riscrivono nello stesso momento possono leggere entrambe 41 e scrivere entrambe 42. flock() con LOCK_EX fa aspettare la seconda finché la prima non rilascia il lock. Qui la modalità giusta è c+: crea il file se serve e, a differenza di w+, non lo svuota prima che tu abbia il lock.

<?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";
}

Output:

Visitor number 1
Visitor number 2
Visitor number 3

I lock sono consultivi: fermano solo altro codice che chiama anch'esso flock(). Per aggiungere una riga, file_put_contents($path, $line, FILE_APPEND | LOCK_EX) fa lo stesso in una chiamata.

Errore comune: while (!feof($fh))

Molti vecchi tutorial usano un ciclo con feof(). Restituisce true solo dopo che una lettura ha già raggiunto la fine, quindi il ciclo gira una volta in più rispetto alle righe e l'ultimo fgets() restituisce 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";

Output:

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

Quel false in più diventa una riga vuota in un report o un elemento vuoto in un array. Fai il ciclo sulla lettura stessa, while (($line = fgets($fh)) !== false), come fanno tutti gli altri esempi di questa pagina.