PHPでCSVファイルを読み込む方法と基本的なエラーハンドリング【ウェブデザイン技能検定 1級学科範囲】

2024年7月5日 2024年7月5日 7分

タスラ t3l

CSVファイルをPHPで読み込み、データを表示する方法は多くの場面で役立ちます。
特にデータベースや外部ファイルからデータを取得して表示する際には非常に有用です。
このブログ記事ではCSVファイルの読み込み方法とエラー処理を含む基本的なPHPコードの解説を行います。

また、ウェブデザイン技能検定などで出題されるPHPに関する問題はこういった基礎的な部分が出題されることが多く見受けられますので、そういった意味でもPHPをあまり使用しない方も理解を深めておくとよいと思います。

CSVファイルの内容

以下のような形式のCSVファイルを読み込むことを想定します。

//data.csv

1,リンゴ,220
2,バナナ,230
3,ブドウ,1000
4,イチゴ,1500

PHPコードの解説

CSVファイルを読み込んで表示するための基本的なPHPコードは以下の通りです。

<?php
$fp = fopen("data.csv", "r");
$content = ""; // 内容を格納する変数

while ($filedata = fgetcsv($fp, 1024)) {
    foreach ($filedata as $data) {
        $content .= $data . ", ";
    }
    $content = rtrim($content, ", "); // 最後のカンマを取り除く
    $content .= "<br>";
}

echo $content;
?>

1 各部分の解説
2 エラーハンドリング
3 まとめ

各部分の解説

1. ファイルを開く

$fp = fopen("data.csv", "r");

fopen関数は、指定したファイルを開きます。
"r"は読み込みモードを意味します。

2. 変数の初期化

$content = "";

ファイルの内容を格納するための変数を初期化します。

3. ファイルからデータを読み込む

while ($filedata = fgetcsv($fp, 1024)) {
    foreach ($filedata as $data) {
        $content .= $data . ", ";
    }
    $content = rtrim($content, ", "); // 最後のカンマを取り除く
    $content .= "<br>";
}

fgetcsv関数は、CSVファイルから1行を配列として読み込みます。
whileループは、ファイルの終わりまで1行ずつデータを読み込みます。
- 条件として$filedata = fgetcsv($fp, 1024)を使用しています。fgetcsvはファイルの1行を読み込み、配列として返します。ファイルの終わりに達するとfalseを返すため、ループが終了します。
foreachループは、配列$filedataの各要素を順に処理します。
- $dataは、$filedata配列の各要素を指し、それを$contentに追加します。
rtrim関数を使用して、行末の余分なカンマを取り除きます。
各行のデータをHTMLの改行タグ<br>で区切って$contentに追加します。

4. データを表示する

echo $content;

最後に、読み込んだデータをブラウザに表示します。

エラーハンドリング

ファイルの読み込みや処理中に発生するエラーを適切に処理することも重要です。以下はエラーハンドリングを追加した例です。

<?php
$filename = "data.csv";

// ファイルの存在確認
if (!file_exists($filename)) {
    die("Error: ファイルが存在しません。");
}

$fp = fopen($filename, "r");

if (!$fp) {
    die("Error: ファイルを開くことができません。");
}

$content = ""; // 内容を格納する変数

while ($filedata = fgetcsv($fp, 1024)) {
    if ($filedata === false) {
        die("Error: データを読み込む際にエラーが発生しました。");
    }
    foreach ($filedata as $data) {
        $content .= $data . ", ";
    }
    $content = rtrim($content, ", "); // 最後のカンマを取り除く
    $content .= "<br>";
}

fclose($fp);

echo $content;
?>