PHP fopen(): Membuka, Membaca, Menulis File (Semua Mode)

fopen('data.txt', 'r') membuka file dan mengembalikan handle, yaitu stream resource yang diterima fungsi-fungsi file lainnya sebagai argumen pertama. Baca dengan fgets() (satu baris) atau fread() (sejumlah byte), tulis dengan fwrite(), dan tutup dengan fclose(). Argumen keduanya adalah mode: 'r' untuk membaca, 'w' untuk menulis, 'a' untuk menambahkan di akhir.

<?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() mengembalikan false saat tidak bisa membuka file-nya (file tidak ada dalam mode r, folder-nya tidak ada, tidak punya izin), dan PHP mencetak warning seperti:

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

Jadi periksa false sebelum memakai handle-nya. Untuk membaca atau menulis seluruh file kecil dalam satu panggilan, file_get_contents() dan file_put_contents() lebih pendek; fopen() dipakai untuk file yang dibaca sepotong demi sepotong atau dibiarkan tetap terbuka.

Mode fopen

Dua baris ini sering mengejutkan. r+ menimpa byte yang sudah ada di tempatnya, tanpa menyisipkan, dan a+ selalu menulis di akhir, bahkan setelah kamu memindahkan pointer dengan fseek() (memindahkannya hanya berpengaruh pada pembacaan):

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

Di Windows, kamu mungkin melihat 'rb' atau 'wb': flag b berarti biner dan mencegah Windows menerjemahkan akhir baris. Flag ini tidak berpengaruh apa-apa di Linux dan macOS, jadi menambahkannya tidak berbahaya dan portabel.

Membaca file baris per baris dengan fgets()

fgets() mengembalikan baris berikutnya termasuk \n-nya, dan false di akhir file. Karena hanya satu baris yang ada di memori setiap saat, loop ini bisa menangani file log sebesar apa pun, dan kamu bisa berhenti lebih awal dengan 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

Bandingkan dengan false memakai !==, jangan memakai while ($line = fgets($fh)) biasa: baris yang hanya berisi "0" tanpa baris baru (baris terakhir sebuah file bisa seperti itu) bernilai falsy dan akan menghentikan loop terlalu cepat.

Menulis dan menambahkan dengan fwrite()

fwrite() menulis string di posisi saat ini dan mengembalikan jumlah byte yang ditulis, atau false kalau gagal. fputs() adalah fungsi yang sama dengan nama lain. Buka dengan 'a' untuk menambahkan ke akhir file tanpa menyentuh isi yang sudah ada:

<?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 adalah akhir baris dari sistem tempat PHP berjalan (\n di Linux dan macOS, \r\n di Windows). Untuk file yang dibaca program lain, pilih salah satu secara eksplisit, biasanya "\n".

Membaca dan menulis file CSV dengan fgetcsv() dan fputcsv()

fputcsv() menulis array sebagai satu baris CSV dan memberi kutip pada field yang mengandung koma, tanda kutip, atau baris baru. fgetcsv() membaca satu baris kembali sebagai array. Berikan pemisah, karakter pembungkus, dan karakter escape kosong secara eksplisit: itu menghasilkan CSV standar, dan PHP 8.4 mencetak deprecation notice kalau argumen escape tidak ditulis.

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

Memecah baris dengan explode(',', $line) langsung rusak begitu sebuah field mengandung koma; fgetcsv() menangani kutipnya untukmu. Untuk file yang dipisahkan titik koma (umum pada hasil ekspor Excel di Eropa), berikan ';' sebagai pemisah.

Berpindah posisi di file dengan fseek(), ftell(), dan rewind()

File yang terbuka punya posisi. Pembacaan dan penulisan dimulai dari sana lalu memajukan posisinya. ftell() memberi tahu di mana posisinya, fseek() memindahkannya ke offset byte tertentu, dan rewind() kembali ke awal. Dengan w+, kamu bisa menulis file lalu membacanya kembali lewat handle yang sama:

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

Mengunci file dengan flock()

Dua request yang membaca sebuah penghitung, menambah satu, lalu menulisnya kembali pada saat bersamaan bisa sama-sama membaca 41 dan sama-sama menulis 42. flock() dengan LOCK_EX membuat request kedua menunggu sampai request pertama melepas lock-nya. Mode c+ adalah yang tepat di sini: mode ini membuat file kalau perlu dan, tidak seperti w+, tidak mengosongkannya sebelum kamu memegang 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

Lock bersifat advisory: hanya menghentikan kode lain yang juga memanggil flock(). Untuk menambahkan satu baris, file_put_contents($path, $line, FILE_APPEND | LOCK_EX) melakukan hal yang sama dalam satu panggilan.

Kesalahan umum: while (!feof($fh))

Banyak tutorial lama memakai loop dengan feof(). Fungsi ini baru mengembalikan true setelah sebuah pembacaan sudah mencapai akhir, jadi loop-nya berjalan sekali lebih banyak daripada jumlah barisnya dan fgets() terakhir mengembalikan 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

false tambahan itu menjadi baris kosong di laporan atau elemen kosong di array. Buat loop berdasarkan pembacaannya sendiri, while (($line = fgets($fh)) !== false), seperti setiap contoh lain di halaman ini.