PHPでSJISのCSVファイルをUTF-8で楽に処理するサンプルコード
PHPでCSV(SJIS)を読み込んで、データをUTF-8にして処理する方法です。
CSVの文字コード処理って意外と面倒だったりしますよね。
このサンプルコードは、CSV(SJIS)ファイルからデータベースにUTF-8として保存したい時などに役に立ちます。
サンプルコード
(PHP 4, PHP 5, PHP 7。PHP 8.4 以降は下の補足のとおり1か所変えてください)
// localeを設定
setlocale(LC_ALL, 'ja_JP.UTF-8');
// SJISのCSVファイル
$filename = 'data.csv';
// ファイルを開く
$data = file_get_contents($filename);
// ユニークな一時ファイル作成する
$fp = tmpfile();
// 文字コード変換して一時ファイルに書き込む
fwrite($fp, mb_convert_encoding($data, 'UTF-8', 'SJIS-win'));
// ポインタを先頭に
fseek($fp, 0);
// UTF-8のCSVデータを1行ずつ処理する
while ($line = fgetcsv($fp)) {
// 配列
print_r($line);
}
// close(一時ファイルも削除される)
fclose($fp);
簡単な説明
CSVファイルをSJISとして開き、$dataに代入する。
$dataをUTF-8に変換してから、ユニークな一時ファイルにCSVデータをまるごと書き込みます。
それを1行ずつ処理して使います。
この方法は、SJISのCSVファイルをループで1行ずつ文字コード処理するより、はるかに効率的です。
一時ファイルのファイル名などを取得したい場合
一時ファイルがどこに保存されるのか知りたい場合にどうぞ。
// ユニークな一時ファイル作成する
$fp = tmpfile();
$meta = stream_get_meta_data($fp);
print_r($meta);
// 取得例
Array
(
[timed_out] =>
[blocked] => 1
[eof] =>
[wrapper_type] => plainfile
[stream_type] => STDIO
[mode] => r+b
[unread_bytes] => 0
[seekable] => 1
[uri] => /tmp/phpUY4iRO
)
このサンプルを PHP 8.5 で、「髙橋」「①」「カンマを含む項目」が入った Shift_JIS の CSV に対して実行しました。変換はそのまま正しく動きますが、1行読むたびに次の非推奨の警告が出ます。
Deprecated: fgetcsv(): the $escape parameter must be provided as its default value will change in ... on line 8
PHP 8.4 から、fgetcsv() の $escape 引数を省略すると警告が出るようになりました。今後の版で既定値が変わる予定なので、引数を明示します。あわせて、空行で止まらないように !== false で比べる形にします。
while (($line = fgetcsv($fp, null, ',', '"', '')) !== false) {
print_r($line);
}
Array
(
[0] => 名前
[1] => 住所
)
Array
(
[0] => 髙橋
[1] => 東京都①丁目
)
Array
(
[0] => 山田, 花子
[1] => 大阪府
)
文字コードの指定は 'SJIS-win'(CP932)のままにしてください。'SJIS' にすると、Windows で作った CSV によくある「髙」「①」などが ? に化けます(同じ PHP 8.5 で確認)。
| mb_convert_encoding の指定 | 「髙」(0xFBFC) | 「①」(0x8740) |
|---|---|---|
| 'SJIS-win' | 髙 | ① |
| 'SJIS' | ? | ? |
Excel が書き出す CSV は、Windows の文字(丸数字など)を含む Shift_JIS(CP932)です。手元の PHP 8.5.8 で「①」を変換すると、SJIS では変換できず ?(3f)になり、SJIS-win なら 2バイトの 8740 になりました(2026年11月5日)。
$ php -r '$s = mb_convert_encoding("①", "SJIS-win", "UTF-8"); echo bin2hex($s), PHP_EOL; $t = mb_convert_encoding("①", "SJIS", "UTF-8"); echo bin2hex($t), PHP_EOL;'
8740
3f
| エンコーディング名 | 丸数字・ローマ数字 | Excel の CSV に使えるか |
|---|---|---|
| SJIS | 使えない(? になる) | 文字が欠ける |
| SJIS-win | 使える | 使える(記事のサンプル) |
| CP932 | SJIS-win と同じ扱い | 使える |
| 方向 | 関数の例 |
|---|---|
| CSV(SJIS-win)を読む | mb_convert_encoding($line, 'UTF-8', 'SJIS-win') |
| Excel 用に書き出す | mb_convert_encoding($csv, 'SJIS-win', 'UTF-8') |