Yii2中设置Response Header必须在send()前完成，下载文件需清空默认头、设正确Content-Type和filename*=UTF-8''格式，sendFile()后设Header无效，流式响应要手动全控Header并避免缓冲区干扰。
Yii2里怎么用Response对象设置自定义Header
直接改Response::headers就行，但得在发送前操作——一旦调用send()或输出内容，Header就锁死了。常见错误是放在afterAction里设，结果没生效，因为那时响应已经发出去了。
典型场景：API需要加X-Request-ID、Cache-Control，或者跨域调试时手动补Access-Control-Allow-Origin。
- 用
$response->headers->set('X-My-Header', 'value')覆盖同名头；用add()追加（比如多个Set-Cookie） -
set()会清掉之前同名的，add()不会——别误用set()去加第二个Link头 - 如果启用了
Response::format = Response::FORMAT_JSON，Yii2默认会加Content-Type: application/json，你再set('Content-Type', 'text/plain')能覆盖，但要注意JSON编码逻辑是否还兼容
Yii2下载文件时Header必须设哪几个才不乱码不报错
只设Content-Disposition远远不够。浏览器卡住、弹窗后空白、中文名变%E4%BD%A0%E5%A5%BD……基本都是Header漏项或值格式不对。
关键点不在“怎么设”，而在“按什么顺序、用什么编码、要不要删默认头”。
- 先调
$response->clearHeaders()——Yii2在返回HTML/JSON时会自动塞一堆头，比如Content-Type: text/html，不清理会导致下载失败或类型冲突 - 必须设
Content-Type: application/octet-stream（或对应MIME，如application/pdf），不能留空或沿用默认 -
Content-Disposition里中文文件名要用filename*=UTF-8''xxx格式，例如filename*=UTF-8''%E4%BD%A0%E5%A5%BD.pdf；直接写filename="你好.pdf"在Chrome/Firefox大概率乱码 - 加上
Content-Transfer-Encoding: binary和Expires: 0能减少代理/CDN缓存干扰
为什么Response::sendFile()之后Header设不生效
因为sendFile()内部调了send()并exit，执行完函数整个响应周期就结束了。你在它后面写的$response->headers->set(...)根本没机会运行。
正确做法是把Header设置放在sendFile()调用之前，而且要确保没其他地方提前触发send()（比如日志组件、调试工具栏、某些行为钩子）。
- 别在
beforeAction里设下载Header然后等sendFile()——可能被中间件覆盖 - 如果用
Controller::render()渲染模板后再下载，大概率已输出HTML，Header直接被PHP报Warning: Cannot modify header information - 最稳的方式：在action末尾，
return $this->response->sendFile($path, $name, [...]);，所有Header配置通过第3个参数数组传进去，比如['mimeType' => 'application/csv']，它会自动处理对应Header
用StreamResponse动态生成文件时Header容易漏什么
比如导出Excel、拼接PDF、实时压缩包，靠fopen('php://output')边写边吐，这时候Header必须手动全控——Yii2不会帮你猜。
漏掉Content-Length倒不是大问题（流式传输本来就不知道总长），但漏掉Connection: close或Pragma: no-cache会让某些反向代理（如Nginx+FastCGI）缓存住半截数据，用户看到“已下载0字节”或卡在99%。
- 务必在
fopen('php://output')前完成所有header()或$response->headers->set() - 加
Cache-Control: no-store, no-cache, must-revalidate, max-age=0比单写no-cache更保险 - 如果用
ob_end_clean()清缓冲区，注意它也会清掉已设但未发送的Header——得在ob_end_clean()之后立刻重设一遍 - PHP 8.0+ 开始，
stream_set_chunk_size()影响不大，但flush()调用频率太高反而拖慢下载，建议每写64KB flush一次，别每行都flush
Header这事，表面是加几行代码，实际是跟PHP SAPI、Web服务器、浏览器解析规则、代理缓存层层较劲。一个Content-Disposition少个''，一个sendFile()放错位置，就卡死在用户电脑上——得盯着Network面板看每条请求的Raw Header才能真正闭环。
