序言
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);
}
后记
如果要导出的字段值中会出现",",那么务必在生成字符串的时候将英文逗号转为中文逗号,否则该字段值将被分到两个相邻的单元格,从而出现显示错误,另外,如果字段中出现了引号,那么请务必将引号如上例程序中的那样替换掉~
谢谢您的耐心阅读~