Webman中导出CSV需用Response::create()构造原始响应并设置Content-Type、Content-Disposition等头，禁用OutputMiddleware，手动写入UTF-8 BOM及fputcsv数据，避免缓冲区覆盖和中文乱码。
Webman 默认不自动处理输出缓冲和流式响应，直接套用传统 PHP 的 fputcsv($output, $row) 会卡在缓冲区、触发内存溢出或下载失败——必须手动接管输出流并禁用框架默认的响应包装。
Webman 中如何正确设置 CSV 响应头
Webman 使用 Response 对象构造返回，不能直接调用 header()。否则会被后续 Response 覆盖，导致浏览器无法识别为下载文件。
- 必须用
Response::create()构造原始响应，并显式设置Content-Type和Content-Disposition -
Content-Type推荐用text/csv; charset=utf-8，不要用application/vnd.ms-excel（已过时，部分新版浏览器拒绝解析） - 文件名需
rawurlencode()处理，否则中文名在 Safari 或 Chrome 下可能乱码或截断 - 务必调用
->withHeader('Cache-Control', 'no-cache')和->withHeader('Expires', '0')，避免代理或 CDN 缓存错误响应
为什么 fopen('php://output') 在 Webman 里会失败
Webman 默认启用 OutputMiddleware，它会拦截并重写所有输出内容（比如自动加 <html> 或 JSON 包裹）。直接 fopen('php://output') 写入的数据，最终被中间件覆盖或丢弃。
- 正确做法是：在路由闭包或控制器中，先调用
ob_end_clean()清空已有缓冲 - 再用
response()->withStatus(200)->withHeader(...)->withBody(...)构造响应体 - 或者更稳妥地：用
StreamedResponse（需自行实现），把 CSV 生成逻辑封装为回调函数传入 - 切勿在中间件链中任何位置 echo/print_r/var_dump，哪怕一个空格也会破坏 CSV 结构
导出百万行时 PDO 查询必须禁用缓冲
Webman 常搭配 PDO 连接 MySQL，默认开启 PDO::MYSQL_ATTR_USE_BUFFERED_QUERY，查 100 万行会全量加载进 PHP 内存，直接 OOM。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
立即学习“PHP免费学习笔记（深入）”；
- 创建 PDO 实例时，必须显式关闭缓冲：
new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false]) - 查询后必须用
$stmt->fetch(PDO::FETCH_NUM)逐行取，绝不能用fetchAll() - 若 SQL 中有
JOIN或复杂计算，优先下推到数据库层完成（如日期格式化用DATE_FORMAT(created_at, '%Y-%m-%d')），避免 PHP 循环中重复调用函数 - 每写入约 1000 行后，调用
ob_flush()和flush()，防止 Nginx 或 Apache 的 proxy_buffer 把数据攒太久
中文字段乱码的真正原因和修复点
不是编码设错，而是 Excel 默认不识别 UTF-8，除非你加 BOM。但 BOM 只能加在文件最开头，且只能加一次——Webman 的响应体一旦开始写入就无法回头补。
- 必须在写入第一行（表头）前，先向输出流写入
\xEF\xBB\xBF（即chr(0xEF).chr(0xBB).chr(0xBF)） - 不能用
fputcsv()写 BOM，得用fwrite($fp, "\xEF\xBB\xBF")单独写 - 表头数组本身要用 UTF-8 字符串，不要用
iconv()或mb_convert_encoding()二次转码，否则可能重复编码 - 如果用
StreamedResponse，BOM 必须作为第一个 yield 的字符串，否则 Excel 打开仍会显示“兼容性警告”
最容易被忽略的是：Webman 的 onWorkerStart 里若提前初始化了 PDO 连接，该连接默认仍带缓冲属性，必须在每次请求内重新 setAttribute；还有就是开发环境开了 Xdebug，它会让 yield 生成器性能暴跌，导出时间翻倍——上线前记得关掉。
