SplFileObject::fputcsv

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

SplFileObject::fputcsvフィールドの配列を CSV の行として書き出す

説明

public SplFileObject::fputcsv(
    array $fields,
    string $separator = ",",
    string $enclosure = "\"",
    string $escape = "\\",
    string $eol = "\n"
): int|false

fields の配列を、CSV の行としてファイルに書き出します。

パラメータ

fields

値の配列。

separator

オプションで指定する、フィールドの区切り文字 (シングルバイト文字 一文字のみ)。

enclosure

オプションで指定する。フィールドの囲み文字 (シングルバイト文字 一文字のみ)。

escape

オプションの escape は、エスケープ文字 (シングルバイト文字 最大で一文字) を指定します。 空文字列 ("") を与えると、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構を無効にします。

eol

eol は、 カスタムの行末シーケンスを設定するオプションの引数です。

注意:

enclosure がフィールド内に含まれる場合は、同じ文字を二度続けることでエスケープします。 ただし、その直前に escape がある場合は別です。

戻り値

書き出した文字列の長さを返します。失敗した場合に false を返します。

separatorenclosure が一文字でない場合は false を返し、何もファイルに書き出しません。

エラー / 例外

separatorenclosure が一文字でない場合は E_WARNING レベルのエラーが発生します。

変更履歴

バージョン 説明
8.1.0 オプションの引数 eol が追加されました。
7.4.0 escape パラメータは空文字列を受け入れるようになりました。 この場合、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構が無効になります。

例1 SplFileObject::fputcsv() の例

<?php

$list 
= array (
    array(
'aaa''bbb''ccc''dddd'),
    array(
'123''456''789'),
    array(
'"aaa"''"bbb"')
);

$file = new SplFileObject('file.csv''w');

foreach (
$list as $fields) {
    
$file->fputcsv($fields);
}

?>

上の例は、次の内容をファイル file.csv に書き出します。

aaa,bbb,ccc,dddd
123,456,789
"""aaa""","""bbb"""

参考

  • fputcsv() - 行を CSV 形式にフォーマットし、ファイルポインタに書き込む
  • SplFileObject::fgetcsv() - ファイルから行を取り出し CSV フィールドとして処理する

関連キーワード:  フィールド, 配列, SplFileObject, 文字, , fputcsv, enclosure, escape, eol, string