(PHP 4, PHP 5, PHP 7, PHP 8)
fgetcsv — 从文件指针中读入一行并解析 CSV 字段
$stream,$length = null,$separator = ",",$enclosure = "\"",$escape = "\\"和 fgets() 类似，只除了 fgetcsv() 解析读入的行并找出 CSV 格式的字段然后返回一个包含这些字段的数组。
注意:
此函数会考虑区域设置。例如，如果
LC_CTYPE为en_US.UTF-8，可能会错误的解析某些单字节编码的数据。
stream一个由 fopen()、popen() 或 fsockopen() 产生的有效文件指针。
length
必须大于在 CVS 文件（允许尾随行尾字符）中找到的最长行（以字符为单位）。否则，该行将拆分为
length 字符的块，除非拆分发生在环绕字符内。
忽略此参数（或者设为 0 或者在 PHP 8.0.0 及以后的版本中设为 null）行的最大长度将不受限制，速度稍慢。
separator
可选的 separator 参数，设置字段分隔符。必须是单字节字符。
enclosure
可选的 enclosure 参数，设置字段环绕符。必须是单字节字符。
escape
可选的 escape
参数，设置转义字符。必须是单字节字符或者空字符串。空字符串（""）禁用所有的转义机制。
在输入流中，enclosure 字符在引号字符串内可通过重复自身进行转义，解析后结果中将只保留一个
enclosure 字符。而 escape 字符的行为有所不同：若输入中出现
escape 字符与 enclosure
字符的组合序列，这两个字符都会保留在解析结果中。因此，在默认参数下，类似 "a""b","c\"d" 的 CSV
行将被解析为两个字段，分别为 a"b 和 c\"d。
从 PHP 8.4.0 开始，弃用依赖 escape 的默认值。需要通过位置或使用命名参数明确提供。
当 escape 被设置为非空字符串（""）时，
可能导致生成的 CSV 不符合 » RFC 4180 的要求，
或者无法通过 PHP CSV 函数的往返处理。
escape 的默认值是 "\\"，因此建议显式地将其设置为空字符串。
默认值将在未来的 PHP 版本中更改，不早于 PHP 9.0。
成功时返回包含读取字段的索引数组， 或者在失败时返回 false。
注意:
CSV 文件中的空行将被返回为一个包含有单个 null 字段的数组，不会被当成错误。
注意: 在读取在 Macintosh 电脑中或由其创建的文件时， 如果 PHP 不能正确的识别行结束符，启用运行时配置可选项 auto_detect_line_endings 也许可以解决此问题。
| 版本 | 说明 |
|---|---|
| 8.4.0 | 现在已弃用依赖 escape 的默认值。 |
| 8.3.0 | 如果最后一个字段仅包含未终止的 enclosure，则返回空字符串，而不是带有单个 NULL 字节的字符串。 |
| 8.0.0 |
现在 length 允许为 null.
|
| 7.4.0 |
escape 参数也接受空字符串来禁用所有的转义机制。
|
示例 #1 读取并显示 CSV 文件的整个内容
<?php
$row = 1;
if (($handle = fopen("test.csv", "r")) !== FALSE) {
while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
$num = count($data);
echo "<p> $num fields in line $row: <br /></p>\n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . "<br />\n";
}
}
fclose($handle);
}
?>