如何使用header_register_callback 和http_response_code 設置自定義HTTP 狀態碼？

gitbox 2025-08-15

1. header_register_callback函數概述

header_register_callback是PHP 中一個很少被提及的函數，它允許你註冊一個回調函數，在PHP 輸出HTTP 響應頭之前，修改或附加HTTP 響應頭。這意味著，你可以通過這個函數在PHP 輸出頭信息之前進行自定義操作，包括設置響應的狀態碼、添加自定義的頭信息等。

函數原型：

 <span><span><span class="hljs-title function_ invoke__">header_register_callback</span></span><span>(</span><span><span class="hljs-keyword">callable</span></span><span> </span><span><span class="hljs-variable">$callback</span></span><span>)
</span></span>

$callback ：一個可調用的函數，用來在響應頭被發送之前執行。這個回調函數接收一個array參數，該數組包含當前響應的所有HTTP 頭部信息。

通過這種方式，你可以非常靈活地控制響應頭的內容，確保在發送響應之前進行調整。

2. http_response_code函數概述

http_response_code是PHP 中用來獲取或設置HTTP 響應狀態碼的函數。默認情況下，當PHP 處理請求時，它會自動將狀態碼設置為200（表示請求成功）。但是，如果你希望返回其他狀態碼，可以使用http_response_code函數進行修改。

函數原型：

 <span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$code</span></span><span> = </span><span><span class="hljs-literal">NULL</span></span><span>)
</span></span>

$code ：要設置的HTTP 狀態碼。如果省略此參數，則返回當前的狀態碼。

常見的HTTP 狀態碼包括：

200 ：OK（請求成功）
404 ：Not Found（未找到）
500 ：Internal Server Error（服務器內部錯誤）
403 ：Forbidden（禁止訪問）

3. 設置自定義HTTP 狀態碼的示例

結合header_register_callback和http_response_code函數，我們可以非常方便地設置自定義的HTTP 狀態碼。以下是一個簡單的例子，展示如何根據不同的條件動態設置HTTP 狀態碼。

示例代碼：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 註冊回調函數來修改 HTTP 響應頭</span></span><span>
</span><span><span class="hljs-title function_ invoke__">header_register_callback</span></span><span>(function() {
    </span><span><span class="hljs-comment">// 檢查某些條件並根據條件設置不同的 HTTP 狀態碼</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$_SERVER</span></span><span>[</span><span><span class="hljs-string">'REQUEST_METHOD'</span></span><span>] === </span><span><span class="hljs-string">'POST'</span></span><span>) {
        </span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-number">201</span></span><span>); </span><span><span class="hljs-comment">// 創建成功，返回 201 狀態碼</span></span><span>
    } </span><span><span class="hljs-keyword">elseif</span></span><span> (</span><span><span class="hljs-variable">$_SERVER</span></span><span>[</span><span><span class="hljs-string">'REQUEST_METHOD'</span></span><span>] === </span><span><span class="hljs-string">'DELETE'</span></span><span>) {
        </span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-number">204</span></span><span>); </span><span><span class="hljs-comment">// 刪除成功，無內容返回，返回 204 狀態碼</span></span><span>
    } </span><span><span class="hljs-keyword">else</span></span><span> {
        </span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-number">200</span></span><span>); </span><span><span class="hljs-comment">// 默認返回 200 狀態碼</span></span><span>
    }
});

</span><span><span class="hljs-comment">// 輸出響應內容</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"響應的內容..."</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上述代碼中，我們首先註冊了一個回調函數，在PHP 發送HTTP 響應頭之前進行狀態碼的設置。根據請求方法的不同，我們動態地返回不同的HTTP 狀態碼：

對於POST請求，返回201 Created狀態碼，表示資源成功創建。
對於DELETE請求，返回204 No Content狀態碼，表示刪除成功，但沒有返回內容。
對於其他請求，返回默認的200 OK狀態碼。

4. 注意事項

在使用header_register_callback時，有以下幾點需要特別注意：

調用順序： header_register_callback註冊的回調函數會在所有頭部信息被發送之前執行，因此它能夠確保修改頭部信息（包括狀態碼）在響應發送之前完成。
響應頭的發送：在調用http_response_code函數時，需要確保在任何輸出內容（如HTML 或文本）發送之前設置狀態碼。否則，PHP 會拋出警告，因為響應頭必須在輸出內容之前發送。
兼容性問題： header_register_callback是一個較少使用的函數，某些PHP 版本或配置可能不支持此函數。因此，在生產環境中使用時，最好先進行兼容性測試。

5. 總結

通過結合header_register_callback和http_response_code函數，PHP 開發者可以輕鬆地根據不同的業務邏輯需求返回自定義的HTTP 狀態碼。這不僅有助於提升接口的靈活性，也使得前端或客戶端能夠根據不同的狀態碼進行相應的處理，進一步增強了系統的可維護性和用戶體驗。

希望通過本文的介紹，你能夠更好地理解並使用這兩個函數，在實際開發中更高效地控制HTTP 響應頭和狀態碼。