fputcsv
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
fputcsv — 將行格式化為 CSV 並寫入檔案指針
說明
fputcsv(
resource
array
string
string
): int
resource
$handle
,array
$fields
,string
$delimiter
= ',',string
$enclosure
= '"'): int
fputcsv() 將一行(用
fields
陣列傳遞)格式化為 CSV
格式並寫入由 handle
指定的檔案。
參數
-
handle
-
檔案指針必須是有效的,必須指向由 fopen() 或 fsockopen() 成功打開的檔案(並還未由 fclose() 關閉)。
-
fields
-
值的一個陣列。
-
delimiter
-
可選的
delimiter
參數設定欄位分界符(只允許一個字元)。 -
enclosure
-
可選的
enclosure
參數設定欄位欄位環繞符(只允許一個字元)。
返回值
返回寫入字串的長度, 或者在失敗時返回 false
。
範例
示例 #1 fputcsv() 例子
<?php
$list = array (
array('aaa', 'bbb', 'ccc', 'dddd'),
array('123', '456', '789'),
array('"aaa"', '"bbb"')
);
$fp = fopen('file.csv', 'w');
foreach ($list as $fields) {
fputcsv($fp, $fields);
}
fclose($fp);
?>
以上例子會寫入以下的file.csv
:
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""
註釋
注意: 在讀取在 Macintosh 電腦中或由其建立的檔案時, 如果 PHP 不能正確的識別行結束符,啟用執行時配置可選項 auto_detect_line_endings 也許可以解決此問題。