array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'tr', ), 'this' => array ( 0 => 'function.fgetcsv.php', 1 => 'fgetcsv', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Dosya Sistemi İşlevleri', ), 'prev' => array ( 0 => 'function.fgetc.php', 1 => 'fgetc', ), 'next' => array ( 0 => 'function.fgets.php', 1 => 'fgets', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'tr', 'path' => 'reference/filesystem/functions/fgetcsv.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
fgetcsv — Dosya tanıtıcısından CSV alanlarını çözümleyerek bir satır döndürür
$akım
,$uzunluk
= null
,$ayraç
= ",",$sınırlayıcı
= "\"",$öncelem
= "\\"Satırı okuyup CSV biçemindeki alanları bir dizi içinde döndürmesi dışında fgets() işlevi gibidir.
Bilginize:
Bu işlevde yerel ayarları hesaba katılır. Eğer LANG, örneğin,
tr_TR.UTF-8
ise ISO-8859-9 ile kodlanmış dosyaları bu işlev hatalı okuyacaktır.
akım
fopen(), popen()veya fsockopen() tarafından başarıyla açılmış geçerli bir dosyanın tanıtıcısı.
uzunluk
CSV dosyasındaki en uzun satırdan (satırsonu karakterleri dahil) daha
büyük bir değer içermelidir. Parçalara ayırma sınırlı bir alanda
gerçekleşmeyecekse, satır uzunluk
karakterden
oluşan parçalara bölünür.
Bu bağımsız değişkenin belirtilmemesi (veya PHP 8.0.0 ve sonrası için 0 veya
null
belirtilmesi) durumunda azami satır uzunluğu sınırlanmaz fakat
işlem yavaşlar.
ayraç
İsteğe bağlı bu bağımsız değişken ile alan ayracı (tek baytlık bir karakter) belirtilir.
sınırlayıcı
İsteğe bağlı bu bağımsız değişken ile alan sınırlayıcı (tek baytlık bir karakter) belirtilir.
öncelem
Belirtilmesi seçimlik olup önceleme karakteri (tek baytlık bir
karakter) belirtmekte kullanılır. Boş dizge (""
)
özel önceleme mekanizmasını iptal eder.
Bilginize: Genellikle bir
sınırlayıcı
karakter bir alanın içinde çiftlenerek öncelenir; ancak, öndeki karakterin yeriniöncelem
karakteri alabilir. Bu nedenle, öntanımlı""
karakteri ile\"
aynı anlama gelir.öncelem
karakterininsınırlayıcı
karakteri öncelemek dışında özel bir anlamı yoktur; kendisini de öncelemesi amaçlanmamıştır.
Başarı durumunda okunan alanları içeren indisli bir
dizi, başarısızlık durumunda false
döner.
Bilginize:
CSV dosyasındaki boş bir satır tek bir null içeren bir dizi olarak döndürülür ve bir hata olarak ele alınmaz.
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.
Sürüm: | Açıklama |
---|---|
8.0.0 |
uzunluk artık null olabiliyor.
|
7.4.0 |
öncelem bağımsız değişkeni özel önceleme
mekanizmasını iptal etmek için boş dizge kabul ediyor.
|
Örnek 1 - Bir CSV dosyasının okunup basılması
<?php
$row = 1;
if (($handle = fopen("test.csv", "r")) !== FALSE) {
while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
$num = count($data);
echo "<p> $row satırındaki $num alan: <br /></p>\n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . "<br />\n";
}
}
fclose($handle);
}
?>