PHP读取CSV出错怎么解决?fgetcsv使用教程

PHP读取CSV文件时频繁报错？其实绝大多数问题都源于路径错误、权限不足、UTF-8 BOM干扰或fgetcsv函数参数配置不当——本文手把手教你从文件存在性校验、安全打开句柄、智能去除BOM头，到精准设置分隔符与包裹符，最后规范释放资源，覆盖完整健壮读取流程，帮你一次性定位并解决“fgetcsv expects parameter 1 to be resource”等典型错误，让CSV解析稳定又省心。

PHP读取CSV文件时报错，多数情况是由于文件路径、编码格式或fgetcsv函数使用不当导致。直接报错如“Warning: fgetcsv() expects parameter 1 to be resource”说明传入的不是有效文件句柄。要解决这类问题，需逐步排查文件是否存在、是否成功打开、编码是否兼容，并正确使用fgetcsv函数。

检查文件路径与打开状态

确保CSV文件路径正确，且PHP有读取权限。

示例代码：

$filename = __DIR__ . '/data.csv';
if (!file_exists($filename)) {
    die("文件不存在");
}
$handle = fopen($filename, 'r');
if (!$handle) {
    die("无法打开文件");
}

处理编码问题（尤其是UTF-8带BOM）

Windows导出的CSV常以UTF-8 with BOM保存，BOM头会导致首行字段名异常，如出现“姓名”这类乱码。

示例：

$header = fgetcsv($handle);
if ($header && strpos(bin2hex($header[0]), 'efbbbf') === 0) {
    $header[0] = substr($header[0], 3); // 去除BOM
}

fgetcsv函数正确用法详解

fgetcsv用于从文件指针中读取一行并解析为数组，参数设置影响解析结果。

常见调用方式：

while (($row = fgetcsv($handle, 0, ',', '"')) !== FALSE) {
    print_r($row);
}

如果CSV用分号分隔，应改为：fgetcsv($handle, 0, ';')

关闭文件句柄与完整流程示例

读取完成后必须调用fclose释放资源，否则可能引发内存或文件锁问题。

完整安全读取示例：

$filename = __DIR__ . '/data.csv';
if (!file_exists($filename)) {
    die("文件不存在");
}

$handle = fopen($filename, 'r');
if (!$handle) {
    die("无法打开文件");
}

$data = [];
while (($row = fgetcsv($handle, 0, ',')) !== FALSE) {
    // 处理BOM（仅第一行）
    if (empty($data) && is_string($row[0]) && substr(bin2hex($row[0]), 0, 6) === 'efbbbf') {
        $row[0] = substr($row[0], 3);
    }
    $data[] = $row;
}

fclose($handle);

print_r($data);

基本上就这些。只要确保文件可读、编码正确、fgetcsv参数匹配分隔符，并处理好BOM，大多数读取错误都能解决。不复杂但容易忽略细节。

今天关于《PHP读取CSV出错怎么解决?fgetcsv使用教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于php调用的内容请关注golang学习网公众号！