HOWTO · PHP
在 PHP 中返回上一頁
本教程介紹如何在 PHP 中返回上一頁
本頁內容
若要將訪客帶回包含表單的頁面,請從 $_SERVER 讀取可選的 HTTP_REFERER 值,只接受允許的本機目的地,並在輸出回應前使用 header() 傳送 Location 標頭。來源網址不一定存在,因此請設定安全的本機備用目的地。
在 PHP 中使用 HTTP_REFERER 請求標頭返回上一頁
index.php 中的表單可以將資料提交給 home.php 之類的處理程式。瀏覽器可能會在 HTTP_REFERER 請求標頭中傳送表單頁面的網址,PHP 則會透過 $_SERVER['HTTP_REFERER'] 提供這個值。瀏覽器或隱私設定可能會省略此標頭,用戶端也可能提供任意值,因此未經驗證前不要直接將它用作重新導向目的地。這個標頭只是請求附帶的提示,並非可靠的瀏覽紀錄;即使它不存在,應用程式仍應正常運作。
在 index.php 中,表單可以在提交時一併傳送訊息:
<form action="home.php" method="post"><input type="hidden" name="message" value="Saved."><button type="submit">Submit</button></form>
以下是完整的 home.php 處理程式,只接受本機的 /index.php 路徑。此範例使用了 str_contains(),因此需要 PHP 8.0 或更新版本。它會保留該頁面原有的查詢參數、加入提交的訊息;若來源網址不存在或指向其他位置,則改用 /index.php。從命令列執行時,範例會使用一個示範請求並印出重新導向目標,提供可在本機呈現的成功流程;透過網頁請求執行時,則會傳送 303 重新導向並結束程式。
<?php
// home.php
$isCli = PHP_SAPI === 'cli';
// Provide a sample request when running this file directly with PHP CLI.
if ($isCli) {
$_SERVER['REQUEST_METHOD'] = 'POST';
$_SERVER['HTTP_REFERER'] = 'https://example.test/index.php?tab=profile';
$_POST['message'] = 'Saved.';
}
if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
http_response_code(405);
exit;
}
$message = $_POST['message'] ?? 'Your form was submitted.';
if (!is_string($message)) {
$message = 'Your form was submitted.';
}
$destination = '/index.php';
$referrer = $_SERVER['HTTP_REFERER'] ?? '';
$parts = parse_url($referrer);
if (is_array($parts) && ($parts['path'] ?? '') === '/index.php') {
$query = [];
parse_str($parts['query'] ?? '', $query);
$destination = '/index.php';
if ($query !== []) {
$destination .= '?' . http_build_query($query);
}
}
$separator = str_contains($destination, '?') ? '&' : '?';
$target = $destination . $separator . http_build_query(['message' => $message]);
if ($isCli) {
echo $target, PHP_EOL;
exit;
}
header('Location: ' . $target, true, 303);
exit;
對於示範請求,處理程式會印出以下重新導向目標:
/index.php?tab=profile&message=Saved.
返回頁面時,請先跳脫訊息,再將它插入 HTML。查詢參數也可能以陣列形式傳入,因此要先確認查詢值是字串:htmlspecialchars(is_string($_GET['message'] ?? null) ? $_GET['message'] : '', ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8')。處理程式中的 URL 編碼可保護查詢參數;顯示時的 HTML 跳脫則可保護頁面。任何要傳給只接受字串的跳脫函式之值,也應套用相同的字串檢查。
處理程式會根據核准的本機路徑重新組成目的地,而不使用來源網址中的主機,因此外部網址不會成為重新導向目標。此範例刻意採用範圍較窄的路徑允許清單:若應用程式有多個表單頁面,請明確列出每個可接受的本機路徑,並為清單以外的值保留安全的本機備用目的地。範例會保留通過驗證的來源網址之查詢參數,再透過 http_build_query() 新增或取代 message 參數;這樣可避免手動組合 URL 編碼,並讓重新導向路徑與查詢字串分開處理。
header() 必須在任何 HTML、空白字元或其他回應內容輸出前執行。重新導向後的 exit 可避免處理程式後續程式碼繼續執行,彷彿請求仍照常進行。303 狀態碼會告知瀏覽器,在表單以 POST 提交後,改以 GET 請求跟隨重新導向。命令列分支僅供示範;透過網頁請求執行時,PHP 會傳送回應標頭,而不是將目標網址印成頁面內容。若主機環境使用較早版本的 PHP,請將 str_contains($destination, '?') 改為相容的檢查方式,例如 strpos($destination, '?') !== false,並確認應用程式的其他部分也支援該版本。