PHPで「+ - " ' 」などの記号をCSVファイルで文字列として出力を行いたい場合

Question

PHPにて、CSVファイルの出力を行う処理を作成しているのですが、
以下のものをエクセルでうまく出力する方法をお伺いしたいです。

「0123456789」 → 0が省略されてしまう
「+abcdefg」 → 計算式と判断されエラーになる
「"お名前"」 → ”がうまく出てくれない

また、このファイルはダウンロードできるだけでなく、
アップロードするファイルと共有にしたいのでできるだけ元の値を保持したいです。

//CSV出力
$filename = "出力ファイル".".csv";;
$csvheader = ["no","ID","名前","カテゴリー","備考"];
$cnt = 1;
$f = fopen($filename, "w");
mb_convert_variables('SJIS', 'UTF-8', $csvheader);
fputcsv($f, $csvheader);
if ( $f ) {
        for($i = 0; $i < count($list); $i++){
                $line = [$cnt,$list[$i]->id,$list[$i]->name,$list[$i]->cate,$list[$i]->info];
                mb_convert_variables('SJIS', 'UTF-8', $line);
                fputcsv($f, $line);
                $cnt++;
        }
}
fclose($f);

---

・試したこと

値の出力の際に　「=""」を追加して文字列だと認識されるように追加しました。

$line = [$cnt,'="'.$list[$i]->id.'"','="'.$list[$i]->name.'"',・・・（以下略）];

この場合だと0が省略されないようになり、
+-などの記号で計算が行われることがなくなりましたが、
「”」が値の中に入っている場合「=""」が表示されてしまい値としては正しくないものになってしまいました。

また、アップロードする際は「=""」が入らないようにしたいと考えております。
理由としてはエクセルでcsvに値を追加する場合、
毎回「=""」を入力しなければならない状態を避けたいためになります。

出力と入力でcsvの値を崩さない方法や
参考になるドキュメントなどご存知でしたらお伺いしたいです。。。

拙い質問で大変申し訳ございません。
お手数をおかけしますが、どうぞよろしくお願い致します。

Comments

[takasima20]

直接 Excel ファイルを生成したら? SYLK 形式っててもあるけど知らない人がとまどいそうかなあ。

[yowayowanitohei]

takasima20様

ご回答ありがとうございます。今回の実装につきましては、
csvの形式が指定されているため他ができずに困っていました。

txtでなんとか組み立ててエクセル表示とかだとうまく行けそうなものなのですが。。。
csvの奥深さに気づいた次第です。

Answer 1

「”」が値の中に入っている場合「=""」が表示されてしまい値としては正しくないものになってしまいました。

ExcelのCSVでは引用符の中の引用符は2つ重ねることになっていますので、
データ中の"を""に置換した上で、前後に="と"を付ければ良いかと思います。

あとは、拡張子をtxtに変えるなどしてExcelで読む時に全体をテキストとして読み込んでから、区切り位置機能で分割するかですね。

Comments

[yowayowanitohei]

otn様
ご回答ありがとうございます。
""の置換が必要なのですね！符号がついた場合でも表示させることができました！

Answer 2

エクセルで直接CSVを読むときの問題なので、エクセル側で読み方を
工夫する気がないなら、出力側で調整するしかないでしょう

="0123456789"
="+abcdefg"
"""お名前"""

Comments

[yowayowanitohei]

yamabejp様

ご回答ありがとうございます。
やはり出力である程度加工が必要そうですね。

そちらのソースで間違いなく動作すること確認できました。

Answer 3

yamabejp様　otn様 　takasima20様　（回答順）　

ご回答ありがとうございました。
それぞれのアドバイスをもとに出力での調整をおこないなんとか実装できました。
計算記号や符号などをエクセルで表示できるようにするための方法について、
csvをアップロード・ダウンロードする場合それぞれのケースだと解説されている記事も多いのですが、
アップロードファイルとダウンロードファイルが同一の仕様の解説が他に見当たりませんでしたので
今回の解決策のみ簡潔にまとめさせていただきます。

---

今回の流れとしては以下を想定しておりました。

1.以下のようなcsvでWebアプリからダウンロードする

no,code,name,category,call
1,+312,スタジオ"smpl",store,0120123456
2,-123,漁港"minato",city,01201122334
3,z906,建設"hoge",store,0123456789

それぞれの行で+-や符号などが入っており、そのままエクセルで読み込むとname?となってしまいます。

ご指摘を受けて、出力の際に「=" "」を付け、
既存の符号の場合は"を""に置換するようにしました。

//CSV出力
$filename = "出力ファイル".".csv";;
$csvheader = ["no","code","name","category","call"];
$cnt = 1;
$f = fopen($filename, "w");
mb_convert_variables('SJIS', 'UTF-8', $csvheader);
fputcsv($f, $csvheader);
if ( $f ) {
        for($i = 0; $i < count($list); $i++){
                //「"」を置換
                $list[$i]->name = str_replace('"', '""', $list[$i]->name);
                //「=" "」を挿入    
                $line = [$cnt,'="'.$list[$i]->code.'"',$list[$i]->name,$list[$i]->cate,'="'.$list[$i]->call.'"'];
                mb_convert_variables('SJIS', 'UTF-8', $line);
                fputcsv($f, $line);
                $cnt++;
        }
}
fclose($f);

_

2.ダウンロードしたcsvにデータを追記しwebアプリにアップロードする

出力のみだとこれで終了なのですが、csvファイルをもとにアップロードを実施する場合、
純粋なデータに加工のため挿入した「=" "」が邪魔になり、置換によってデータが変になってしまいます。
そのため、アップロード処理で挿入した「=" "」を削除し、置換を戻す処理を追加しました。

        foreach($list as $val){
            $listSet = explode(",", $val); 

            //エクセルでの表示設定を解除する
            if(strpos($listSet[1],'="') !== false){
                $listSet[1] = str_replace('"=""', '', $listSet[1]);
                $listSet[1] = substr($listSet[1], 0, -3);
            }
            $listSet[1] = str_replace('""""', '"', $CategorySet[1]);

            $ary_placeholder[] = " (?, ?, ?, ?)";
            $ary_value[] = $listSet[1];
            $ary_value[] = $listSet[2];
            $ary_value[] = $listSet[3];
            $ary_value[] = $listSet[4];
        }

上記のようにアップロードファイルとダウンロードファイルの共通化を行う場合に
エクセルからの表示も、正しいデータのアップロードも行うことができました。