本文介绍一种健壮、兼容性强的方法：不依赖 fseek() 硬跳字节，而是动态检测并剥离首行首字段中的 utf-8 bom（ef bb bf），从而统一处理带/不带 bom 的 csv 文件，避免读取异常或数据错位。
本文介绍一种健壮、兼容性强的方法：不依赖 fseek() 硬跳字节，而是动态检测并剥离首行首字段中的 utf-8 bom（ef bb bf），从而统一处理带/不带 bom 的 csv 文件，避免读取异常或数据错位。
在实际生产环境中，CSV 文件来源多样，有的以 UTF-8 with BOM 编码（Windows Excel 常见），有的为纯 UTF-8（无 BOM）。若直接使用 fseek($handle, 3) 强制跳过前 3 字节，当文件不包含 BOM 时，会错误截断真实数据（如将 "ID;Name" 变成 ";Name"），导致解析失败或入库错乱。
更可靠的做法是：在读取首行后，仅对第一列（$data[0]）进行 BOM 检测与清除，其余字段保持原样。UTF-8 BOM 的字节序列为 \xEF\xBB\xBF，可直接用 str_replace() 安全移除，且该操作对无 BOM 的字符串完全无副作用（替换不存在的子串返回原字符串）。
以下是优化后的核心逻辑片段（已整合进原流程）：
if (($handle = fopen($file, "r")) !== false) {
$firstRow = true;
$bi1_values = [];
while (($data = fgetcsv($handle, 9000000, ";")) !== false) {
// 仅对首行首字段检测并清除 UTF-8 BOM
if ($firstRow && !empty($data) && isset($data[0])) {
$data[0] = str_replace("\xEF\xBB\xBF", "", $data[0]);
$firstRow = false;
}
// 正常处理每一行数据（注意：此处需确保 $date1, $date2 已正确定义）
if (!empty($data)) {
$bi1_values[] = sprintf(
"(%s, %s, '%s', '%s', %s, %s, %s, %s)",
"'" . addslashes($data[0]) . "'",
"'" . addslashes(str_replace("'", "''", $data[1])) . "'",
$date1,
$date2,
"'" . addslashes($data[2]) . "'",
"'" . addslashes($data[4]) . "'",
"'" . addslashes(str_replace("'", "''", $data[5])) . "'",
"'" . addslashes(str_replace("'", "''", $data[6])) . "'"
);
}
if (count($bi1_values) === 1000) {
$query = "INSERT INTO dbo.Sales (storenumber, storename, date, time, TransRef, stylecode, color, size) VALUES " . implode(',', $bi1_values);
$stmt = $conn->query($query);
if (!$stmt) {
error_log("SQL Error in BI1 import: " . $query . "\n", 3, "D:/xampp/htdocs/errors/erreur_BI1.txt");
}
$bi1_values = [];
}
}
// 批量插入剩余数据（防止最后一组不足 1000 条被遗漏）
if (!empty($bi1_values)) {
$query = "INSERT INTO dbo.Sales (storenumber, storename, date, time, TransRef, stylecode, color, size) VALUES " . implode(',', $bi1_values);
$conn->query($query);
}
fclose($handle);
// 安全移动文件
if (!rename($file, $dest . basename($file))) {
error_log("Failed to move file: {$file}", 0);
}
}✅ 关键优势说明：
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
立即学习“PHP免费学习笔记（深入）”；
- 零风险兼容：无论文件是否含 BOM，均能正确解析首列；
- 无需预判编码：避免 fseek() 导致的“有 BOM 时正常、无 BOM 时损坏”的陷阱；
- 语义清晰：BOM 处理逻辑紧贴数据消费点，职责单一，易于维护；
- 防御性增强：增加 !empty($data) 和 isset($data[0]) 判断，防止空行或字段缺失引发 Notice。
⚠️ 注意事项：
- 请确保 $date1 和 $date2 在循环外已正确定义（原代码中未体现，属业务逻辑依赖）；
- addslashes() 或 str_replace("'", "''") 仅适用于 SQL Server 的简单转义，强烈建议升级为 PDO 预处理语句以杜绝 SQL 注入；
- fgetcsv() 默认按系统 locale 解析，若 CSV 含非 ASCII 字符（如中文），请确认 PHP 运行环境默认编码为 UTF-8（可通过 ini_set('default_charset', 'UTF-8') 强制）；
- 大文件处理时，建议添加内存与超时控制（如 set_time_limit(0)、ini_set('memory_limit', '512M')）。
通过此方案，您的导入脚本将真正实现“BOM 透明化”，稳定支撑多源 CSV 数据接入。
