PHP fopen(): Dosya Açma, Okuma ve Yazma (Modlar)

fopen('data.txt', 'r') bir dosyayı açar ve bir tanıtıcı, yani diğer dosya fonksiyonlarının ilk argüman olarak aldığı bir akış kaynağı döndürür. fgets() (bir satır) veya fread() (belirli sayıda bayt) ile okuyun, fwrite() ile yazın ve fclose() ile kapatın. İkinci argüman moddur: okumak için 'r', yazmak için 'w', eklemek için 'a'.

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

Çıktı:

Got: apple
Got: banana
Got: cherry

fopen() dosyayı açamadığında (dosya r modunda yok, bir klasör eksik, izin yok) false döndürür ve PHP şuna benzer bir uyarı yazdırır:

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

Bu yüzden tanıtıcıyı kullanmadan önce false kontrolü yapın. Küçük bir dosyanın tamamını tek çağrıda okumak veya yazmak için file_get_contents() ve file_put_contents() daha kısadır; fopen() parça parça okuduğunuz veya açık tuttuğunuz dosyalar içindir.

fopen modları

İki satır insanları şaşırtır. r+ araya eklemeden var olan baytların üzerine yerinde yazar ve a+ işaretçiyi fseek() ile hareket ettirdikten sonra bile her zaman sona yazar (onu hareket ettirmek yalnızca okumaları etkiler):

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

Çıktı:

Xbc
Xbc
Xbc
end

Windows'ta 'rb' veya 'wb' görebilirsiniz: b bayrağı ikili (binary) demektir ve Windows'un satır sonlarını çevirmesini önler. Linux ve macOS'ta hiçbir şey yapmaz, bu yüzden eklemek zararsızdır ve taşınabilirdir.

fgets() ile bir dosyayı satır satır okuma

fgets() bir sonraki satırı \n dahil olarak, dosyanın sonunda ise false döndürür. Bellekte her seferinde yalnızca bir satır olduğu için bu döngü her boyuttaki bir log dosyasını işler ve break ile erken durabilirsiniz:

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

Çıktı:

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

Düz bir while ($line = fgets($fh)) ile değil, !== kullanarak false ile karşılaştırın: yalnızca "0" içeren ve yeni satırı olmayan bir satır (bir dosyanın son satırı böyle olabilir) falsy'dir ve döngüyü erken bitirirdi.

fwrite() ile yazma ve ekleme

fwrite() geçerli konuma bir dizge yazar ve yazılan bayt sayısını, başarısızlıkta false döndürür. fputs() başka bir addaki aynı fonksiyondur. Oradakine dokunmadan bir dosyanın sonuna eklemek için 'a' ile açın:

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

Çıktı:

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

PHP_EOL PHP'nin çalıştığı sistemin satır sonudur (Linux ve macOS'ta \n, Windows'ta \r\n). Başka programların okuduğu dosyalar için açıkça birini seçin, genellikle "\n".

fgetcsv() ve fputcsv() ile CSV dosyalarını okuma ve yazma

fputcsv() bir diziyi tek bir CSV satırı olarak yazar ve virgül, tırnak veya yeni satır içeren alanları tırnak içine alır. fgetcsv() bir satırı geri bir dizi olarak okur. Ayırıcıyı, çevreleyiciyi ve boş bir kaçış karakterini açıkça verin: bu standart CSV verir ve kaçış argümanı yazılmadığında PHP 8.4 bir kullanımdan kaldırma bildirimi yazdırır.

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

Çıktı:

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

Satırları explode(',', $line) ile bölmek bir alan virgül içerdiği anda bozulur; fgetcsv() tırnaklamayı sizin için ele alır. Noktalı virgülle ayrılmış bir dosya için (Avrupa'daki Excel dışa aktarımlarında yaygındır) ayırıcı olarak ';' verin.

fseek(), ftell() ve rewind() ile bir dosyada dolaşma

Açık bir dosyanın bir konumu vardır. Okumalar ve yazmalar oradan başlar ve onu ileri taşır. ftell() nerede olduğunu söyler, fseek() onu bir bayt konumuna taşır ve rewind() başa döner. w+ ile bir dosya yazıp aynı tanıtıcı üzerinden geri okuyabilirsiniz:

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

Çıktı:

11
world
hello world

flock() ile bir dosyayı kilitleme

Aynı anda bir sayacı okuyup bir ekleyen ve geri yazan iki istek ikisi de 41 okuyup ikisi de 42 yazabilir. LOCK_EX ile flock() ikincisinin, ilki kilidi serbest bırakana kadar beklemesini sağlar. Burada doğru mod c+ olur: gerekirse dosyayı oluşturur ve w+ aksine kilidi almadan önce onu boşaltmaz.

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

Çıktı:

Visitor number 1
Visitor number 2
Visitor number 3

Kilitler tavsiye niteliğindedir: yalnızca flock() çağıran diğer kodu durdurur. Tek bir satır eklemek için file_put_contents($path, $line, FILE_APPEND | LOCK_EX) aynısını tek çağrıda yapar.

Sık yapılan hata: while (!feof($fh))

Birçok eski eğitim feof() ile döngü kurar. O, ancak bir okuma sona zaten çarptıktan sonra true döndürür, bu yüzden döngü satır sayısından bir fazla çalışır ve son fgets() false döndürür:

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

Çıktı:

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

O fazladan false bir raporda boş bir satıra ya da bir dizide boş bir elemana dönüşür. Bu sayfadaki diğer her örneğin yaptığı gibi döngüyü okumanın kendisine kurun: while (($line = fgets($fh)) !== false).