將行格式化為 CSV 並寫入檔案指針

fputcsv

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

fputcsv — 將行格式化為 CSV 並寫入檔案指針

說明

fputcsv(
    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 也許可以解決此問題。

參見

  • fgetcsv() - 從檔案指針中讀入一行並解析 CSV 欄位

Leave a Reply

Your email address will not be published. Required fields are marked *