PHP headers_sent() 函数

headers_sent ([ string &$file [, int &$line ]] ) : bool

<?php
// 检查头信息是否已发送
if (headers_sent()) {
    echo "HTTP 头已经发送，无法再发送新的头信息。\n";
} else {
    echo "HTTP 头尚未发送，可以发送新的头信息。\n";
    // 这里可以安全地使用 header() 函数
    header("X-Custom-Header: MyValue");
}
?>

<?php
// 假设在发送一些输出后检查
echo "Some output before checking headers.\n";

// 检查头信息是否已发送，并获取位置
if (headers_sent($file, $line)) {
    echo "头信息已经开始发送。\n";
    echo "发送开始的文件: " . $file . "\n";
    echo "发送开始的行号: " . $line . "\n";

    // 这对于调试 "headers already sent" 错误非常有用
} else {
    echo "头信息尚未发送。\n";
    header("Content-Type: text/plain");
}
?>

<?php
/**
 * 安全地发送 HTTP 头信息
 * @param string $header 要发送的头信息字符串
 * @param bool $replace 是否替换相同类型的头信息
 * @param int $response_code 强制指定的 HTTP 响应码
 * @return bool 如果头信息发送成功返回 true，否则返回 false
 */
function safe_header($header, $replace = true, $response_code = null) {
    if (headers_sent()) {
        // 记录错误到日志，而不是显示给用户
        error_log("无法发送头信息 '$header'，头信息已经发送。");
        return false;
    }

    if ($response_code !== null) {
        header($header, $replace, $response_code);
    } else {
        header($header, $replace);
    }

    return true;
}

// 使用安全函数发送头信息
if (safe_header("Content-Type: application/json")) {
    echo json_encode(['status' => 'success']);
} else {
    // 备选方案：可能需要使用其他方式发送数据
    echo '{"status": "error", "message": "无法设置头信息"}';
}
?>

<?php
// 模拟一个常见的错误场景：在输出之后尝试发送头信息

// 一些输出（可能来自包含文件或错误的空格）
echo "Some output before header.\n";

// 现在尝试发送头信息
if (!headers_sent()) {
    header("Location: /newpage.php");
    exit;
} else {
    // 获取头信息开始发送的位置
    headers_sent($file, $line);

    echo "<h1>调试信息</h1>\n";
    echo "<p>无法重定向，因为头信息已经发送。</p>\n";
    echo "<p>头信息开始发送的文件: <code>" . htmlspecialchars($file) . "</code></p>\n";
    echo "<p>头信息开始发送的行号: <code>" . $line . "</code></p>\n";

    // 提供更多调试信息
    echo "<h2>可能的解决方案：</h2>\n";
    echo "<ul>\n";
    echo "<li>检查文件 <code>" . htmlspecialchars($file) . "</code> 的第 " . $line . " 行之前是否有输出</li>\n";
    echo "<li>检查文件开头是否有空格或空行</li>\n";
    echo "<li>确保文件保存为无 BOM 的 UTF-8 格式</li>\n";
    echo "<li>使用输出缓冲（ob_start()）来延迟输出</li>\n";
    echo "</ul>\n";
}
?>

<?php
// 开始输出缓冲
ob_start();

// 在缓冲区内进行输出
echo "This output is buffered.\n";
echo "It won't cause headers to be sent yet.\n";

// 检查头信息是否已发送（应该返回 false）
if (headers_sent()) {
    echo "ERROR: Headers already sent!\n";
} else {
    echo "Headers not sent yet - we can still set them.\n";

    // 安全地设置头信息
    header("Content-Type: text/plain");
    header("X-Custom-Header: BufferedExample");
}

// 更多输出
echo "More buffered output.\n";

// 结束缓冲并发送所有内容
ob_end_flush();

// 现在头信息已经发送
if (headers_sent()) {
    echo "\nNow headers have been sent.\n";
}

// 尝试在头信息发送后设置新头信息（会失败）
if (!headers_sent()) {
    header("Another-Header: This will fail");
} else {
    echo "Cannot set Another-Header because headers already sent.\n";
}
?>

<?php
/**
 * HTTP 响应类
 */
class HttpResponse {
    /**
     * 发送 JSON 响应
     * @param mixed $data 要编码为 JSON 的数据
     * @param int $status_code HTTP 状态码
     * @return bool 成功返回 true，失败返回 false
     */
    public static function json($data, $status_code = 200) {
        // 检查头信息是否已发送
        if (headers_sent()) {
            error_log("Cannot send JSON response: headers already sent");
            return false;
        }

        // 设置 JSON 头信息
        header("Content-Type: application/json; charset=UTF-8");
        http_response_code($status_code);

        // 输出 JSON 数据
        echo json_encode($data, JSON_PRETTY_PRINT);

        return true;
    }

    /**
     * 重定向到指定 URL
     * @param string $url 要重定向到的 URL
     * @param int $status_code 重定向状态码（301 或 302）
     * @return bool 成功返回 true，失败返回 false
     */
    public static function redirect($url, $status_code = 302) {
        if (headers_sent()) {
            error_log("Cannot redirect to $url: headers already sent");

            // 备选方案：使用 JavaScript 重定向
            echo '<script>window.location.href="' . htmlspecialchars($url) . '";</script>';
            echo '<noscript><meta http-equiv="refresh" content="0;url=' . htmlspecialchars($url) . '"></noscript>';
            return false;
        }

        // 使用适当的 HTTP 状态码进行重定向
        if ($status_code === 301) {
            header("Location: $url", true, 301);
        } else {
            header("Location: $url", true, 302);
        }

        return true;
    }
}

// 使用示例
HttpResponse::json(['message' => 'Hello, World!']);

// 或者在需要时重定向
if ($some_condition) {
    HttpResponse::redirect('/newpage.php', 301);
    exit;
}
?>