PHP之导出CSV文件

序言

Q1：什么是csv文件？

A1：csv即 comma-separated values ，逗号分隔值。是一种通用的相对简单地文件格式，目前被较为广泛的使用。其最广泛的应用就是用来转移表数据。

“CSV”并不是一种单一的、定义明确的格式（尽管RFC 4180有一个被通常使用的定义）。因此在实践中，术语“CSV”泛指具有以下特征的任何文件：

1.纯文本，使用某个字符集，比如ASCII、Unicode、EBCDIC或GB2312；

2.由记录组成（典型的是每行一条记录）；

3.每条记录被分隔符分隔为字段（典型分隔符有逗号、分号或制表符；有时分隔符可以包括可选的空格）；

4.每条记录都有同样的字段序列

Q2：什么是BOM？

A2：BOM即为Byte Order Mark，字节顺序标记（详见百度百科）。在Windows自带的记事本等软件，当其在保存一个utf-8格式编码的文件时，就会默认在文件头加上三个不看见的字符(0xEF 0xBB 0xBF)，来确保自身再次打开时，可以以utf-8格式来打开文件，从而杜绝乱码现象。在一般情况下来说，这并不会有什么大的麻烦，但是，对于本文的导出csv中，若导出数据为utf-8编码格式的，当导出的csv文件在windows系统打开时（尤其是用excel）打开时，就会出现乱码情况。所以，为了杜绝出现此类情况，请在导出到csv文件时，记得在文件的最头部加上BOM头，从而使得你导出的csv文件可以正确显示。

正文：

下面，分享一下如何使用PHP导出csv文件。

大体思路是这样子的：由于csv文件是一种由逗号分隔字段的文件格式，所以，我们可以将准备导入的字段用逗号 “,” 隔开，在每一行的尾部加上”\r\n”。

此外还有一点需要注意的地方，那就是文件的BOM头，如果忽略了BOM头的话，你以UTF-8编码形式输出的csv文件在windows中打开很可能会是一堆乱码。该如何解决这个问题呢？一是运用转码函数iconv，将utf-8格式的字符串转换为gb2312格式的，这样在Windows下打开就不会乱码了，还有另外的一个思路就是在文件的开头加上BOM信息头，这样当在windows系统下打开这个文件时，系统就会得知这个文件的编码格式，从而避免了乱码输出的情况。

而对于Csv文件的导出，经博主查看了各路大神的分享之后，对于csv文件的导出总结了大概这两种方法：

方法一，直接以echo的形式直接输出：

/*按csv文件的标准生成字符串，为了避免乱码，该方法使用了将utf-8格式的字符串转换为gb2312的方法
*@param
*$content=array(
*     'fields' => array(
*                       'field1' => '字段1',
*                     'field2' => '字段2',
*                           ......
*
*                      ),
*       'data' => array(
*                            0 =>array(
*                                         'field1' => 'val01',
*                                         'field2' => 'val02',
*                                           ......
*                                        ),
*                            1 =>array(
*                                         'field1' => 'val11',
*                                         'field2' => 'val12',
*                                           ......
*                                        ),
*                               ......
*                       ),
*
*);
*生成csv表样式为：
*  字段1  字段2  字段3  字段4  ......
*  val01  val02  val03  val04  ......
*  val11  val12  val13  val14  ......
*    .......
*/
public function csvGenerator($content)
    {

        $str = '';//csv内容所保存的字符串
        foreach ($content['fields'] as $val) {
            $str .= (iconv('utf-8', 'gb2312', $val) . ",");//设置表头 将表头依次设置为字段1、字段2...

        }
        $str .= "\r\n";
        foreach ($content['data'] as $kkk => $row) {
            foreach ($content['fields'] as $k => $v) {
                $row[$k] = str_replace('"', '""', $row[$k]);
                $str .= (iconv('utf-8', 'gb2312', $row[$k]) . ",");
            }
            $str = substr($str, 0, -1);//去掉每行最后一个逗号；
            $str .= "\r\n";
        }

        return $str; //
    }

/**导出csv文件（csv文件下载）直接echo的方法：
     *@param $filename
     * 输出csv文件的文件名
     * @param $data
     * 要写入csv文件的内容，即经过csvGenerator处理过的字符串；
     */
     function csvExport($filename='export.csv',$data){

        header("Content-type:application/csv");
        header("Content-Disposition:attachment;filename=".$filename);
        header("Cache-Control:must-revalidate,post-check=0,pre-check=0");
        header('Expires:0');
        header('Pragma:');
        echo $data;
        return true;

    }

方法二，以文件的形式输出：

/*按csv文件的标准生成字符串，这里并未对编码方式进行处理，而是采用了在文件头加BOM的方式，详见csvExportWithBOM函数
*@param
*$content=array(
*     'fields' => array(
*                       'field1' => '字段1',
*                     'field2' => '字段2',
*                           ......
*
*                      ),
*       'data' => array(
*                            0 =>array(
*                                         'field1' => 'val01',
*                                         'field2' => 'val02',
*                                           ......
*                                        ),
*                            1 =>array(
*                                         'field1' => 'val11',
*                                         'field2' => 'val12',
*                                           ......
*                                        ),
*                               ......
*                       ),
*
*);
*生成csv表样式为：
*  字段1  字段2  字段3  字段4  ......
*  val01  val02  val03  val04  ......
*  val11  val12  val13  val14  ......
*    .......
*/
public function csvGenerator($content)
    {

        $str = '';//csv内容所保存的字符串
        foreach ($content['fields'] as $val) {
            $str .= ($val . ",");//设置表头 将表头依次设置为字段1、字段2...

        }
        $str .= "\r\n";
        foreach ($content['data'] as $kkk => $row) {
            foreach ($content['fields'] as $k => $v) {
                $row[$k] = str_replace('"', '""', $row[$k]);
                $str .= ($row[$k] . ",");
            }
            $str = substr($str, 0, -1);//去掉每行最后一个逗号；
            $str .= "\r\n";
        }

        return $str;
    }

输出csv文件

/**@param $filename
     * 输出csv文件的文件名
     * @param $data
     * 要写入csv文件的内容，即经过csvGenerator处理过的字符串；
     */
    public function csvExportWithBOM($filename='export.csv', $data)
    {
        $f=fopen("php://memory",'w');
        fwrite($f, chr(0xEF).chr(0xBB).chr(0xBF).$data);//加入BOM头
        fseek($f,0);
        header('Content-Type: application/csv');
        // 告知浏览器想要输出的是一个文件
        header('Content-Disposition: attachment; filename="'.$filename.'";');
        // make php send the generated csv lines to the browser
        fpassthru($f);

    }

后记

如果要导出的字段值中会出现","，那么务必在生成字符串的时候将英文逗号转为中文逗号，否则该字段值将被分到两个相邻的单元格，从而出现显示错误，另外，如果字段中出现了引号，那么请务必将引号如上例程序中的那样替换掉~

谢谢您的耐心阅读~