萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 取得當前 URL 與查詢參數:分頁、重導向的實用工具函數

需求場景

分頁、排序、篩選等功能需保留現有查詢參數,僅新增或替換 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。

copyright © 萬盛學電腦網 all rights reserved