fgetcsv()是PHP读取CSV最稳妥方案，专为CSV设计，能正确解析引号、换行、嵌套逗号等；需显式指定分隔符、处理BOM、限制行长并校验数据。
fgetcsv() 是你在 Echo 框架里读 CSV 文件最稳的选择，不是因为它是“框架推荐”，而是它原生支持引号包裹、换行字段、逗号转义等真实 CSV 场景——用 file_get_contents() + explode() 会当场翻车。
怎么在 Echo 中接收并保存上传的 CSV 文件
Echo 本身不处理 multipart 表单解析，得靠 echo.MultipartForm 或手动读取 c.Request().MultipartReader()。但更常见也更安全的做法是：先保存到临时路径，再解析。
- 用
c.FormFile("file")获取上传的*multipart.FileHeader，检查Filename后缀是否为.csv - 调用
header.Open()得到io.ReadCloser，用os.CreateTemp("", "upload-*.csv")写入临时文件（避免内存爆掉） - 别直接用
c.FormValue()拿文件名拼路径——用户可控字段，可能构造../../etc/passwd - 临时文件写完后记得
defer os.Remove(tempPath)，但要在入库完成后删，否则并发导入时可能误删
用 fgetcsv() 解析时必须设对的三个参数
fgetcsv() 默认用逗号分隔、双引号包裹、反斜杠转义，但现实 CSV 经常不按套路出牌。你得显式传参，否则遇到中文标题、含逗号的地址字段、Excel 导出带 BOM 的文件，立马报错或错行。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 分隔符：用
fgetcsv($handle, 0, ',')—— 第二个参数设0表示不限制行长度（防截断），第三个参数明确指定分隔符，别依赖默认值 - 包裹符：如果 CSV 用单引号包裹字段（少见但存在），得自己预处理或改用
str_getcsv()配合file()逐行读 - BOM 头：UTF-8 文件开头可能有
\xEF\xBB\xBF，会导致第一行字段名多出乱码。读取前用fseek($fp, 3, SEEK_SET)跳过，或用mb_convert_encoding(file_get_contents($path), 'UTF-8', 'UTF-8')清洗
入库前必须做校验，不能全交给 PDO 的 prepare/execute
CSV 导入不是“把数组塞进 SQL”，而是数据清洗的第一道关。PDO 不会帮你判断手机号是不是 11 位、邮箱格式对不对、日期是不是合法的 Y-m-d。漏掉校验，轻则脏数据进库，重则触发唯一索引冲突导致整批回滚。
- 第一行通常是 header，用
fgetcsv()读一次存进$headers数组，后续每行用array_combine($headers, $row)转成关联数组，方便按字段名取值 - 空值处理：CSV 里的空字符串
""、" "、"NULL"要统一转成null或默认值，别直接 bindParam 绑定 - 批量插入别用单条
INSERT：组装INSERT INTO t (a,b,c) VALUES (?,?,?), (?,?,?), ...，一次最多 500 行，避免 SQL 过长或事务锁表太久 - 失败行要记录原始行号和错误原因（比如 “第127行：email 格式错误”），不能只返回 “共导入 98 条，失败 2 条”
事务边界和错误恢复容易被忽略
很多人把整个 CSV 导入包在一个事务里，看起来很“原子”，但实际风险极高：文件大、网络抖动、数据库连接超时，都会让事务卡住甚至被 kill。更务实的做法是分块事务 + 断点续传标记。
- 每 100 行 commit 一次，用
try/catch包裹每一块，失败时记录当前已成功行数（比如写进 Redis 或临时表） - 不要用
ROLLBACK TO SAVEPOINT回滚某几行——MySQL 的 savepoint 在 prepare statement 场景下行为不稳定 - 如果业务允许，入库成功后才删临时 CSV；如果要求强一致性，入库同时写一条
import_log记录状态（pending → processing → success/failed） - 特别注意：
fgetcsv()读到损坏行（如编码错乱、字段数不匹配）会返回false，此时必须break并记录错误位置，否则后续所有行都会偏移
