本文详解如何使用 php-cgi 的 -q（静默模式）和 -d expose_php=off 参数，彻底屏蔽默认输出的 HTTP 响应头（如 Content-Type 和 X-Powered-By），使其行为更接近 php.exe，适用于命令行调试、构建脚本或轻量级 CGI 测试场景。
本文详解如何使用 `php-cgi` 的 `-q`（静默模式）和 `-d expose_php=off` 参数，彻底屏蔽默认输出的 http 响应头（如 `content-type` 和 `x-powered-by`），使其行为更接近 `php.exe`，适用于命令行调试、构建脚本或轻量级 cgi 测试场景。
php-cgi 是 PHP 的 CGI 版本，设计初衷是与 Web 服务器（如 Nginx）配合处理 HTTP 请求，因此默认会输出完整的 HTTP 响应头——包括 X-Powered-By、Content-Type 及空行分隔符。这在命令行直接调用时显得冗余，尤其当你仅需获取脚本的原始输出（如 JSON 或 HTML 内容）时，这些头部信息会干扰解析或破坏数据格式。
幸运的是，PHP 提供了两个内置参数，可精准控制该行为：
✅ 解决方案：组合使用 -q 与 -d
- -q（Quiet-mode）：抑制所有 HTTP 头部输出（含 Content-Type、Status、空行等），但保留 X-Powered-By（若启用）；
- -d expose_php=off：关闭 X-Powered-By 头（需配合 -q 使用，否则仍会输出其他头）。
二者结合即可实现“纯净输出”，效果等同于 php index.php：
# ✅ 推荐：完全静默（无任何 HTTP 头） php-cgi -q -d expose_php=off index.php # ✅ 等效写法（-d 可前置或后置） php-cgi -d expose_php=off -q index.php
? 示例验证：
对你提供的 index.php（含双 header() 调用），执行上述命令后，输出将仅为：{"$_SERVER":{"ALLUSERSPROFILE":"C:\ProgramData","APPDATA":"..."}}不再包含 X-Powered-By、Content-Type 或额外空行。
立即学习“PHP免费学习笔记（深入）”；
⚠️ 注意事项
- -q 不会影响脚本内 header() 函数的行为：若你在 PHP 代码中显式调用 header('Content-Type: application/json')，该头仍会被输出（除非你也禁用它）；-q 仅屏蔽 PHP 自动添加的默认头。
- expose_php=off 是运行时覆盖，不修改 php.ini，适合临时调试；如需全局生效，可在 php.ini 中设置 expose_php = Off。
- 避免混淆：php-cgi -q ≠ php。php（CLI SAPI）天生无 HTTP 头逻辑，而 php-cgi -q 是在 CGI SAPI 上主动抑制头输出，二者底层机制不同。
- Windows 下路径注意：确保 php-cgi.exe 在 PATH 中，或使用绝对路径调用（如 C:phpphp-cgi.exe -q ...）。
? 总结
| 场景 | 推荐命令 |
|---|---|
| 快速测试脚本输出（去头） | php-cgi -q index.php |
| 彻底隐藏所有 PHP 标识头 | php-cgi -q -d expose_php=off index.php |
| 构建/CI 环境中稳定使用 | 将上述命令封装为脚本或 Makefile 目标 |
掌握这两个参数，你就能灵活切换 php-cgi 的“Web 模式”与“工具模式”，兼顾兼容性与简洁性，让命令行 PHP 开发更高效、更可控。
