(PHP 4, PHP 5, PHP 7, PHP 8)
fgets — Dosya tanıtıcısından bir satır döndürür
Belirtilen dosya tanıtıcısından bir satır döndürür.
akımDosya tanıtıcısı geçerli olmalı ve fopen() veya fsockopen() tarafından başarıyla açılmış bir dosya için döndürülmüş olmalıdır (ve henüz fclose() tarafından kapatılmamış olmalıdır).
uzunlukuzunluk - 1 bayt okununca bir satırsonu karakterinde veya dosya sonunda (hangisi önce vuku bulursa) okuma işlemi durur. Bir uzunluk belirtilmezse akımdan okuma işlemi satırın sonuna erişilinceye kadar sürdürülür.
Dosya tanıtıcısı akım ile belirtilen bir dosyadan uzunluk - 1 baytlık veriyi bir dizge içinde döndürür. Dosya konumlayıcıdan başka veri okunamıyorsa false döner.
Bir hata oluşursa false döner.
Örnek 1 - Bir dosyanın satır satır okunması
<?php
$dt = @fopen("/tmp/inputfile.txt", "r");
if ($dt) {
while (($buffer = fgets($dt, 4096)) !== false) {
echo $buffer;
}
if (!feof($dt)) {
echo "Hata: beklenmeyen fgets() başarısızlığı\n";
}
fclose($dt);
}
?>Bilginize: Eğer PHP'nin Macintosh bilgisayarlarda çalışırken veya bu bilgisayarlarda oluşturulmuş dosyalarla çalışırken satır sonlarını tanımamaması gibi bir sorunla karşılaşılaşılırsa, auto_detect_line_endings çalışma anı seçeneği etkin kılınarak bu sorun çözülebilir.
Bilginize:
fgets() işlevinin 'C' dilindeki anlamlandırılmasını bilenler dosya sonu karakterinin (EOF) döndürülüşü ile ilgili farka dikkat etmelidir.