PHP导入Google Sheet至数据库：空白单元格被上方值覆盖问题

我完全懂你现在的困扰——从Google Sheet API拉取数据后，空白单元格居然会用上一行的对应值来填充，导致数据库里本该是null的位置全变成了重复数据。这其实是两个常见问题叠加的结果：Google Sheets API默认会省略行末尾的空白单元格，再加上你代码里的$fields数组没有在每次循环时重置，所以上一行的数据就残留下来了。

下面是针对你代码的具体修复方案，一步步来解决：

核心修复要点 #

1. 每次循环重置$fields数组：确保处理每一行数据时，都是从一个干净的新数组开始，不会继承上一行的残留值。
2. 显式检查单元格值的有效性：对每个字段，先确认对应的索引在$row数组中存在，并且值不是空白字符串，否则直接设置为null。

修改后的完整代码 #

public function eventsData() { 
    $range = 'Events'; 
    $values = []; 
    Sheetapi::getSpreadsheetData($values, $range); 

    if (empty($values)) { 
        print "No data found.\n"; 
    } else { 
        $keys = array_shift($values); 

        foreach ($values as $row) { 
            // 关键：每次循环开始时重置$fields，彻底避免上一行数据残留
            $fields = [];
            
            if (!empty($row)) { 
                // 逐个字段处理：先找索引，再判断值是否有效，无效则设为null
                $eventIndex = array_search('Event Name', $keys);
                $eventValue = isset($row[$eventIndex]) && trim($row[$eventIndex]) !== '' ? $row[$eventIndex] : null;
                StrAdaptator::f($fields, 'event', $eventValue);

                $typeIndex = array_search('Event Type', $keys);
                $typeValue = isset($row[$typeIndex]) && trim($row[$typeIndex]) !== '' ? $row[$typeIndex] : null;
                StrAdaptator::f($fields, 'type', $typeValue);

                $dateIndex = array_search('Event Date', $keys);
                $dateValue = isset($row[$dateIndex]) && trim($row[$dateIndex]) !== '' ? $row[$dateIndex] : null;
                DateAdaptator::f($fields, 'date', $dateValue, DateAdaptator::YYYYMMDDshort);

                $cityIndex = array_search('City', $keys);
                $cityValue = isset($row[$cityIndex]) && trim($row[$cityIndex]) !== '' ? $row[$cityIndex] : null;
                StrAdaptator::f($fields, 'city', $cityValue);

                $firstnameIndex = array_search('First Name', $keys);
                $firstnameValue = isset($row[$firstnameIndex]) && trim($row[$firstnameIndex]) !== '' ? $row[$firstnameIndex] : null;
                StrAdaptator::f($fields, 'firstname', $firstnameValue);

                $lastnameIndex = array_search('Last Name', $keys);
                $lastnameValue = isset($row[$lastnameIndex]) && trim($row[$lastnameIndex]) !== '' ? $row[$lastnameIndex] : null;
                StrAdaptator::f($fields, 'lastname', $lastnameValue);

                $emailIndex = array_search('Email', $keys);
                $emailValue = isset($row[$emailIndex]) && trim($row[$emailIndex]) !== '' ? $row[$emailIndex] : null;
                EmailAdaptator::f($fields, 'email', $emailValue);

                $phoneIndex = array_search('Phone', $keys);
                $phoneValue = isset($row[$phoneIndex]) && trim($row[$phoneIndex]) !== '' ? $row[$phoneIndex] : null;
                StrAdaptator::f($fields, 'phone', $phoneValue);
                PhoneAdaptator::f($fields, 'E164', $phoneValue);

                $socialIndex = array_search('Social Media Handle', $keys);
                $socialValue = isset($row[$socialIndex]) && trim($row[$socialIndex]) !== '' ? $row[$socialIndex] : null;
                StrAdaptator::f($fields, 'socialMediaHandle', $socialValue);

                $genreIndex = array_search('Musical Genre', $keys);
                $genreValue = isset($row[$genreIndex]) && trim($row[$genreIndex]) !== '' ? $row[$genreIndex] : null;
                StrAdaptator::f($fields, 'musicalGenre', $genreValue);

                StrAdaptator::f($fields, 'market', 'B2C'); 
            } 

            try { 
                Agnostik::sql_insertUpdate('events', $fields, self::WITH_SQL_LOG); 
            } catch (PDOException $e) { 
                echo "\r\n" . 'PDO Exception: ' . $e->getMessage(); 
            } 
            print_r($fields); 
        } 
    } 
}

额外注意事项 #

• 记得确认你的StrAdaptator、DateAdaptator等格式化类能正确处理null值。比如在它们的f方法里，如果传入的值是null，应该直接保留null，而不是转换成空字符串。
• 如果Google Sheets里的空白单元格是真正的空值（不是用户输入的空格），trim($row[$index]) !== ''可以简化为!empty($row[$index])，但用trim能过滤掉不小心输入的空格，更稳妥。

内容的提问来源于stack exchange，提问作者Mathias