PHPでCSVファイルを読み込んで解析する方法【サンプルコード付き】

PHPでは、fopen()関数とfgetcsv()関数を組み合わせることで、CSVファイルを簡単に解析（パース）できます。fopen()の引数には、読み込みたい.csvファイルのパスを指定します。

基本的なサンプルコード

$row_count = 1;
if (($infile = fopen("path to .csv file", "r")) !== FALSE) {
    while (($data_in_csv = fgetcsv($infile, 800, ",")) !== FALSE) {
        $data_count = count($data_in_csv);
        echo "<p> $data_count in line $row_count: <br /></p>\n";
        $row_count++;
        for ($counter = 0; $counter < $data_count; $counter++) {
            echo $data_in_csv[$counter] . "<br />\n";
        }
    }
    fclose($infile);
}

コードの解説

このコードは、以下のような流れで動作します。

• ファイルを開く： fopen()により、対象のCSVファイルが存在すれば読み取りモード（"r"）で開かれます。
• 1行ずつ読み込む： fgetcsv()がFALSEを返すまでwhileループで繰り返し処理を行います。第2引数の「800」は、1行あたりの最大読み込み文字数のしきい値です。
• 行番号を進める： $row_countカウンタをインクリメントすることで、ファイルの次の行へ処理を移します。
• ファイルを閉じる： 読み込みが完了したら、fclose()でファイルを確実にクローズします。

実行結果

入力されたCSVファイルが解析され、内容が1行ずつ画面に出力されます。

PHP 5.3.0以降で使える簡潔な書き方

PHPのバージョンが5.3.0以上であれば、file()関数とstr_getcsv()関数を組み合わせることで、よりシンプルに記述できます。

$file_to_read = file('path to .csv file');
$data_to_ingest = [];
foreach ($file_to_read as $infile) {
    $data_to_ingest[] = str_getcsv($infile);
}

この方法では、CSVファイル全体を配列として読み込み、各行を個別の配列要素に変換して格納できます。

注意点

注意： 上記のfile()+str_getcsv()の方法は、CSVファイル内に改行コードが含まれている場合には正しく動作しません。これは、file()関数が単純に改行位置で行を分割する仕組みになっており、ダブルクォート（引用符）で囲まれたフィールド内の改行を識別できないためです。

まとめ

PHPでCSVファイルを解析する基本は、fopen()＋fgetcsv()の組み合わせです。大規模なファイルでもメモリ効率よく1行ずつ処理できます。一方、ファイル全体をまとめて配列化したい場合は、PHP 5.3.0以降で利用可能なfile()＋str_getcsv()が便利ですが、フィールド内に改行を含むCSVには対応できない点に留意しましょう。