関数・クラス解説

fputcsv

version:PHP 5 >= 5.1.0, PHP 7 (公式)

行を CSV 形式にフォーマットし、ファイルポインタに書き込む

公式リファレンス

書式

fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\\" ]]] ) : int|false

説明

fputcsv() は、行(fields 配列として渡されたもの)を CSV としてフォーマットし、それを handle で指定したファイルに書き込みます (いちばん最後に改行を追加します)。

パラメータ

handle
ファイルポインタは、有効なファイルポインタである必要があり、fopen() または fsockopen() で正常にオープンされた(そしてまだ fclose() でクローズされていない)ファイルを指している必要があります。
fields
文字列の配列。
delimiter
オプションの delimiter はフィールド区切り文字 (一文字だけ) を指定します。
enclosure
オプションの enclosure はフィールドを囲む文字 (一文字だけ) を指定します。
escape_char
オプションの escape_char は、エスケープ文字 (最大で一文字) を指定します。 空文字("") を指定すると、プロプライエタリなエスケープ機構が無効になります。
注意: enclosure がフィールド内に含まれる場合は、同じ文字を二度続けることでエスケープします。 ただし、その直前に escape_char がある場合は別です。

返値

書き込んだ文字列の長さを返します。失敗した場合に FALSE を返します。

注意

注意: マッキントッシュコンピュータ上で作成されたファイルを読み込む際に、PHP が行末を認識できないという問題が発生した場合、実行時の設定オプションauto_detect_line_endings を有効にする必要が生じるかもしれません。

更新履歴

バージョン 説明
7.4.0 escape_char パラメータが、 プロプライエタリなエスケープ機構を無効にするために空文字列を受け入れるようになりました。
5.5.4 escape_char パラメータが追加されました。

サンプル

例1 fputcsv() の例

$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"""

参考

  • fgetcsv() - ファイルポインタから行を取得し、CSVフィールドを処理する
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール