生产环境必须关闭display_errors=Off并设error_reporting=E_ALL & ~E_NOTICE & ~E_DEPRECATED，同时启用log_errors=On和指定error_log路径，重启FrankenPHP后验证日志记录且响应体无错误文本。
FrankenPHP 生产环境关闭 PHP 错误输出到页面，核心是切断 display_errors 的输出通路，同时确保错误仍被记录——这不是“隐藏错误”，而是防止敏感信息泄露，同时保留可观测性。
确认并关闭 display_errors
FrankenPHP 使用标准 PHP 配置机制，display_errors 必须设为 Off。仅靠代码中 ini_set('display_errors', '0') 不可靠，因 FrankenPHP 启动时已加载配置，运行时设置可能被忽略或覆盖。
- 在
php.ini（或 FrankenPHP 指定的配置文件，如frankenphp.ini）中明确设置：display_errors = Off - 若使用 Docker，确保该配置挂载进容器，且路径正确（例如通过
-v ./php.ini:/etc/php/conf.d/frankenphp.ini） - 重启 FrankenPHP 进程（如
sudo systemctl restart frankenphp或重新运行容器）
同步控制 error_reporting 级别
即使 display_errors = Off，若 error_reporting 过高（如 E_ALL），某些中间件、调试工具或框架层仍可能触发渲染逻辑。生产环境应主动收敛报告范围：
- 在
php.ini中设置：error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_USER_NOTICE - 避免使用
error_reporting(0)——它会完全屏蔽错误触发，导致致命错误（如E_ERROR）无法被日志捕获或自定义处理器接管 - FrankenPHP 不改变 PHP 错误触发机制，因此该设置与传统 FPM 完全一致
启用并验证错误日志记录
关闭页面输出后，必须确保错误写入日志，否则等于“失明”。FrankenPHP 支持标准 log_errors 和 error_log：
立即学习“PHP免费学习笔记（深入）”；
- 在
php.ini中启用：log_errors = Onerror_log = /var/log/frankenphp/error.log - 确保目标目录存在，且 FrankenPHP 进程用户（如
www-data或frankenphp）有写权限：sudo mkdir -p /var/log/frankenphp && sudo chown www-data:www-data /var/log/frankenphp - 可配合
tail -f /var/log/frankenphp/error.log实时验证错误是否正常记录
检查 FrankenPHP 特有层干扰
FrankenPHP 自身不渲染 PHP 错误，但需排除以下常见干扰源：
-
Xdebug：若启用，检查
xdebug.mode是否含develop或debug，且xdebug.force_display_errors = 0（默认为 0，但显式确认更稳妥） -
应用框架：如 Laravel、Symfony 等有自己的调试开关（如
APP_DEBUG=false），需一并关闭，否则框架可能绕过 PHP 原生设置自行输出堆栈 -
HTTP 响应头/内容：用
curl -I或浏览器 Network 面板确认响应体不含Notice:、Warning:等字样，响应状态码为 500 而非 200 + 错误文本
