PHP URL 解析與參數獲取全攻略：四大核心方法深度解析

PHP URL 解析與參數獲取全攻略：四大核心方法深度解析

URL 參數處理是 Web 開發高頻需求。本文系統梳理 PHP 中解析 URL、提取查詢參數的四種核心方法，並提供通用封裝函數，助你靈活應對各類場景。

基礎工具函數：查詢字符串雙向轉換

在深入內置函數前，先建立兩個通用工具函數：

<?php
/**
 * 將查詢字符串轉為關聯數組
 * @param string $query 如 "m=content&c=index&a=lists"
 * @return array ['m'=>'content', 'c'=>'index', 'a'=>'lists']
 */
function convertUrlQuery($query) {
    $params = [];
    foreach (explode('&', $query) as $param) {
        $item = explode('=', $param, 2);  // 限制分割次數，支持值含 =
        $params[$item[0]] = isset($item[1]) ? $item[1] : '';
    }
    return $params;
}

/**
 * 將關聯數組轉為查詢字符串
 * @param array $array_query ['m'=>'content', 'c'=>'index']
 * @return string "m=content&c=index"
 */
function getUrlQuery($array_query) {
    $tmp = [];
    foreach ($array_query as $k => $v) {
        $tmp[] = $k . '=' . $v;
    }
    return implode('&', $tmp);
}

// 使用示例
$url = 'https://www.baidu.com/index.php?m=content&c=index&a=lists&catid=6';
$parts = parse_url($url);
$queryArray = convertUrlQuery($parts['query']);
// $queryArray = ['m'=>'content', 'c'=>'index', 'a'=>'lists', 'catid'=>'6']
$rebuildQuery = getUrlQuery($queryArray);
// $rebuildQuery = "m=content&c=index&a=lists&catid=6"
?>

方法一：$_SERVER 超全局變量（原始直接法）

優點：無函數調用開銷，性能最高
缺點：需自行處理解碼、數組轉換、多值參數等邊界情況

方法二：pathinfo() 函數（路徑信息提取）

$url = "https://localhost/index.php";
$info = pathinfo($url);
print_r($info);
/* 輸出：
Array (
    [dirname] => https://localhost
    [basename] => index.php
    [extension] => php
    [filename] => index
) */

適用場景：僅需提取文件名、擴展名、目錄路徑等路徑級信息
局限性：不解析查詢參數，查詢字符串會被忽略

方法三：parse_url() 函數（標準化 URL 解析）⭐ 推薦

$url = "https://localhost/index.php?name=tank&sex=1#top";
$parts = parse_url($url);
print_r($parts);
/* 輸出：
Array (
    [scheme] => http
    [host] => localhost
    [path] => /index.php
    [query] => name=tank&sex=1
    [fragment] => top
) */

核心優勢：

• 標準化解析，符合 RFC 3986 規範
• 自動分離協議、主機、路徑、查詢、錨點五大組件
• 配合 parse_str() 可直接將 query 轉為數組：
  parse_str($parts['query'], $params);

進階用法：

// 僅獲取特定組件
$host = parse_url($url, PHP_URL_HOST);      // "localhost"
$query = parse_url($url, PHP_URL_QUERY);    // "name=tank&sex=1"
$path = parse_url($url, PHP_URL_PATH);      // "/index.php"

方法四：basename() 函數（文件名提取）

$url = "https://localhost/index.php?name=tank&sex=1#top";
echo basename($url);  // 輸出: index.php?name=tank&sex=1#top

注意：不會自動去除查詢字符串和錨點，純粹按路徑最後一段截取。
若需純文件名：basename(parse_url($url, PHP_URL_PATH))

補充：正則表達式精準提取（特殊場景）

$url = "https://localhost/index.php?name=tank&sex=1#top";
preg_match_all("/(\w+=\w+)(#\w+)?/i", $url, $matches);
print_r($matches);
/* 輸出：
Array (
    [0] => Array ( [0] => name=tank [1] => sex=1#top )
    [1] => Array ( [0] => name=tank [1] => sex=1 )
    [2] => Array ( [0] => [1] => #top )
) */

適用場景：非標準 URL 格式、需提取特定模式參數、舊系統兼容處理
性能提示：正則開銷較大，高頻調用場景優先用內置函數

綜合對比與選型指南

最佳實踐封裝類

class UrlParser {
    public static function parse($url, $component = -1) {
        return parse_url($url, $component);
    }

    public static function getQueryParams($url) {
        $parts = parse_url($url);
        $params = [];
        if (isset($parts['query'])) {
            parse_str($parts['query'], $params);
        }
        return $params;
    }

    public static function buildQuery($params, $numeric_prefix = '') {
        return http_build_query($params, $numeric_prefix);
    }

    public static function getCurrentUrl() {
        $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
        return $protocol . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    }
}

// 使用示例
$params = UrlParser::getQueryParams('https://api.example.com/users?page=2&limit=20&sort=desc');
// ['page'=>'2', 'limit'=>'20', 'sort'=>'desc']
$newQuery = UrlParser::buildQuery(['page' => 3, 'limit' => 20]);
// "page=3&limit=20"

常見坑點避雷

1. parse_url() 不驗證 URL 合法性，僅按分隔符拆分，異常輸入可能返回意外結果
2. parse_str() 會覆蓋同名參數，a=1&a=2 僅保留最後值，需用 parse_str($str, $arr) 且 PHP 7.1+ 支持數組語法 a[]=1&a[]=2
3. URL 編碼一致性：生成 URL 時用 urlencode()，解析時內置函數自動解碼
4. 相對路徑處理：parse_url() 要求完整 URL，相對路徑需先用 parse_url('https://base' . $relative) 處理