分頁、排序、篩選等功能需保留現有查詢參數,僅新增或替換 page 參數。本文提供可重複使用的工具函數,支援移除舊 page、補上新 page、保留其餘參數。
<?php
/**
* 取得當前完整 URL(含查詢字串)
*/
function getCurrentUrl(): string
{
$scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'] ?? 'localhost';
$uri = $_SERVER['REQUEST_URI'] ?? '/';
return $scheme . '://' . $host . $uri;
}
/**
* 產生分頁用 URL:保留原參數,替換/新增 page 參數
* @param int $page 目標頁碼
* @param string|null $baseUrl 基底 URL(預設為當前 URL)
* @return string
*/
function buildPageUrl(int $page, ?string $baseUrl = null): string
{
$baseUrl = $baseUrl ?? getCurrentUrl();
$parsed = parse_url($baseUrl);
$query = $parsed['query'] ?? '';
// 解析查詢字串為陣列
parse_str($query, $params);
// 移除舊 page,設定新 page
unset($params['page']);
if ($page > 1) {
$params['page'] = $page;
}
// 重建查詢字串
$newQuery = http_build_query($params);
// 組合新 URL
$newUrl = $parsed['scheme'] . '://' . $parsed['host'];
if (isset($parsed['port'])) {
$newUrl .= ':' . $parsed['port'];
}
$newUrl .= $parsed['path'] ?? '/';
if ($newQuery !== '') {
$newUrl .= '?' . $newQuery;
}
if (isset($parsed['fragment'])) {
$newUrl .= '#' . $parsed['fragment'];
}
return $newUrl;
}
/**
* 取得指定查詢參數值(支援陣列參數)
*/
function getQueryParam(string $key, mixed $default = null): mixed
{
return $_GET[$key] ?? $default;
}
?>
<?php
$currentPage = max(1, (int)getQueryParam('page', 1));
$totalPages = 10; // 從資料庫查詢取得
echo '<nav aria-label="分頁"><ul class="pagination">';
// 上一頁
if ($currentPage > 1) {
echo '<li class="page-item"><a class="page-link" href="' . buildPageUrl($currentPage - 1) . '">上一頁</a></li>';
}
// 頁碼(簡易版:顯示前後各 2 頁)
$start = max(1, $currentPage - 2);
$end = min($totalPages, $currentPage + 2);
for ($i = $start; $i <= $end; $i++) {
$active = $i === $currentPage ? ' active" aria-current="page' : '';
echo '<li class="page-item' . $active . '">';
echo '<a class="page-link" href="' . buildPageUrl($i) . '">' . $i . '</a></li>';
}
// 下一頁
if ($currentPage < $totalPages) {
echo '<li class="page-item"><a class="page-link" href="' . buildPageUrl($currentPage + 1) . '">下一頁</a></li>';
}
echo '</ul></nav>';
?>
http_build_query() 預設支援陣列參數(如 filter[category]=1&filter[tag][]=a&filter[tag][]=b),parse_str() 也能正確解析。若需保留錨點(#section),上方函數已處理 $parsed['fragment']。
$url . '&page=' . $page:會產生重複 page、遺漏 ?、編碼錯誤。ereg_replace():PHP 7.0+ 已移除,改用 preg_replace() 或上方陣列操作法。parse_url() + parse_str() + http_build_query() 三部曲,標準、安全、可維護。封裝 buildPageUrl() 等工具函數,即可在任何專案快速實作乾淨的分頁連結。核心原則:解析 → 陣列操作 → 重建,避免手動字串拼接導致的 Bug。