【PHP8.x】SplFileObject::fgetcsv()メソッドの使い方

fgetcsvメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月04日

基本的な使い方

fgetcsvメソッドは、PHPのSplFileObjectクラスに属し、CSV（Comma Separated Values）形式のファイルから一行を読み込み、その内容を配列として解析するメソッドです。このメソッドは、ファイルポインタが指す現在の位置から次の改行文字までを一行として読み込み、指定された区切り文字や囲み文字、エスケープ文字のルールに従って、各フィールドを抽出します。そして、抽出されたフィールド群を要素とする配列を戻り値として提供します。

引数には、読み込む最大行長（length）、フィールドの区切り文字（delimiter、デフォルトはカンマ ,）、フィールド値を囲む文字（enclosure、デフォルトはダブルクォート "）、そしてエスケープ文字（escape、デフォルトはバックスラッシュ \）を任意で指定できます。これらのオプションを適切に設定することで、標準的なCSV形式だけでなく、多様な形式のCSVデータを正確に処理することが可能となります。

戻り値は、正常に一行が読み込まれ解析できた場合、フィールドを格納した配列です。ファイルの終端（EOF）に達したときや、読み込みに失敗した場合にはfalseを返します。また、ファイル内に空の行が存在し、それを読み込んだ場合は空の配列[]を返します。

SplFileObjectのfgetcsvメソッドを利用することで、ファイルポインタの管理を意識することなく、シンプルかつ効率的にCSVファイルを操作できます。これは、大量のデータを含むCSVファイルの処理や、外部システムから受け取ったCSVデータのインポート処理などで特に有効であり、システム開発においてCSVデータを扱う上で非常に基本的なかつ重要な機能の一つです。

構文(syntax)


1<?php
2$file = new SplFileObject('file.csv', 'r');
3$row = $file->fgetcsv();
4?>

引数(parameters)

string $separator = ",", string $enclosure = """, string $escape = "\"

string $separator = ",": CSVファイルの区切り文字を指定する文字列。デフォルトはカンマ（,）。
string $enclosure = """: CSVファイルの囲み文字を指定する文字列。デフォルトはダブルクォーテーション（"）。
string $escape = "\": CSVファイルのエスケープ文字を指定する文字列。デフォルトはバックスラッシュ（\）。

戻り値(return)

array|false

CSV形式の行を配列として返します。ファイルポインタは読み込んだフィールドの数だけ進められます。エラーが発生した場合は false を返します。