IIS中为PHP致命错误的HTTP响应添加Content-Type头的方法

环境信息 #

• 系统：Windows 10
• Web服务器：IIS 10
• 数据库：MySQL 8.0
• PHP版本：8.1.10

核心问题 #

正常运行时，PHP+IIS会返回Content-Type: text/html; charset=UTF-8响应头，浏览器能正确解析内容；但触发PHP致命错误（比如停止mysqld.exe导致数据库连接失败）时，IIS响应缺失该头，浏览器默认用Windows-1252编码解析UTF-8格式的错误信息，导致乱码。

已尝试的方案：

• try-catch捕获异常：仅能处理非致命错误，属于临时 workaround
• 修改php.ini的default_charset为Windows-1251：无效
• 配置web.config的mimeMap：无效

需要专门针对PHP致命错误的响应添加Content-Type: text/html; charset=UTF-8头，不依赖异常捕获。

可行解决方案 #

方法1：注册PHP shutdown函数处理致命错误 #

PHP的register_shutdown_function可以在脚本终止（包括致命错误触发的终止）时执行代码，我们可以利用它手动发送正确的响应头。

把这段代码放在项目入口文件（比如index.php）的最顶部：

register_shutdown_function(function() {
    $lastError = error_get_last();
    // 只处理致命错误类型
    $fatalErrorTypes = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR];
    if ($lastError && in_array($lastError['type'], $fatalErrorTypes)) {
        // 发送UTF-8编码的Content-Type头
        header('Content-Type: text/html; charset=UTF-8');
        // 输出格式化的错误信息（也可以保留PHP默认错误格式，这里是示例）
        echo '<div style="padding: 20px; background: #f8d7da;">';
        echo '<h3>致命错误</h3>';
        echo '<p>消息：' . htmlspecialchars($lastError['message'], ENT_QUOTES, 'UTF-8') . '</p>';
        echo '<p>文件：' . htmlspecialchars($lastError['file'], ENT_QUOTES, 'UTF-8') . '</p>';
        echo '<p>行号：' . $lastError['line'] . '</p>';
        echo '</div>';
    }
});

这段代码会在致命错误发生时，先发送正确的编码头，再输出错误信息，避免浏览器乱码。

方法2：配置IIS自定义500错误页 #

通过IIS拦截500状态码的响应，转发到自定义脚本添加编码头：

1. 打开IIS管理器，选中目标站点，点击「错误页」
2. 找到状态码500的条目，双击编辑
3. 选择「执行URL」，输入自定义错误处理脚本路径（比如/error_handler.php）
4. 在站点根目录创建error_handler.php，内容如下：

<?php
// 强制发送UTF-8编码头
header('Content-Type: text/html; charset=UTF-8');
// 获取IIS传递的错误信息
$errorMsg = $_SERVER['HTTP_X_IIS_ERROR_DESCRIPTION'] ?? '服务器内部发生致命错误';
?>
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>服务器错误</title>
</head>
<body>
    <h1>500 服务器内部错误</h1>
    <p><?php echo htmlspecialchars($errorMsg, ENT_QUOTES, 'UTF-8'); ?></p>
</body>
</html>

5. 同时在web.config中添加配置确保IIS转发错误：

<system.webServer>
    <httpErrors errorMode="Custom">
        <remove statusCode="500" subStatusCode="-1" />
        <error statusCode="500" path="/error_handler.php" responseMode="ExecuteURL" />
    </httpErrors>
</system.webServer>

方法3：调整PHP.ini错误输出配置 #

修改php.ini中的以下参数，确保PHP输出错误时自动携带UTF-8编码头：

; 开发环境开启错误输出，生产环境建议关闭
display_errors = On
; 设置默认输出编码为UTF-8
default_charset = "UTF-8"
; 强制错误输出为HTML格式，确保编码头被正确发送
html_errors = On

如果之前改default_charset无效，可能是IIS在致命错误时直接接管了响应，搭配方法1使用效果更稳定。

内容的提问来源于stack exchange，提问作者Ilya Chalov