(PHP 5 >= 5.1.0, PHP 7, PHP 8)
fputcsv — Satırı CSV olarak biçemler ve dosya tanıtıcısına yazar
$akım,$alanlar,$ayraç = ",",$sınırlayıcı = "\"",$öncelem = "\\",$satır_sonu = "\n"
fputcsv() işlevi alanlar dizisi
içinde aktarılan bir dizgeyi bir CSV satırı olarak biçemler ve sonuna bir
satırsonu karakteri ekleyerek akım ile belirtilen
dosya tanıtıcısına yazar.
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).
alanlarDizge dizisi.
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.
satır_sonu
Seçimlik satır_sonu bağımsız değişkeni ile satırsonu
karakteri değiştirilebilir.
When escape is set to anything other than an empty string
("") it can result in CSV that is not compliant with
» RFC 4180 or unable to survive a roundtrip
through the PHP CSV functions. The default for escape is
"\\" so it is recommended to set it to the empty string explicitly.
The default value will change in a future version of PHP, no earlier than PHP 9.0.
Bilginize:
sınırlayıcıkarakteri içeren bir alan varsa veöncelemkarakteri ile öncelenmemişse,sınırlayıcıkarakter kendisiyle öncelenir.
Başarısızlık durumunda false aksi takdirde yazılan dizgenin uzunluğu
döner.
| Sürüm: | Açıklama |
|---|---|
| 8.1.0 |
Seçimlik satır_sonu bağımsız değişkeni eklendi.
|
| 7.4.0 |
öncelem bağımsız değişkeni, özel önceleme
mekanizmasını iptal edebilmek için artık boş dizge kabul ediyor.
|
Örnek 1 - fputcsv() örneği
<?php
$liste = array (
array('aaa', 'bbb', 'ccc', 'dddd'),
array('123', '456', '789'),
array('"aaa"', '"bbb"')
);
$dt = fopen('file.csv', 'w');
foreach ($liste as $alan) {
fputcsv($dt, $alan);
}
fclose($dt);
?>
Yukarıdaki örnek file.csv dosyasına şunları yazar:
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""
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.