萬盛學電腦網

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

PHP URL 解析四大方法實戰:parse_url、pathinfo 等完整比較

場景:從未知 URL 獲取參數、路徑、主機等信息

已知參數名用 `$_GET['name']` 直接取。未知結構需解析完整 URL 字串。

方法一:$_SERVER 超全局變量 (原始、無解析)

<?php
// 假設當前請求 URL: https://example.com/path/script.php?name=tank&sex=1#top
echo $_SERVER['QUERY_STRING'];      // "name=tank&sex=1" (僅查詢字串)
echo $_SERVER['REQUEST_URI'];       // "/path/script.php?name=tank&sex=1#top" (含路徑、查詢、片段)
echo $_SERVER['HTTP_HOST'];         // "example.com" (Host 頭)
echo $_SERVER['SERVER_NAME'];       // "example.com" (配置名)
?>

缺點:僅限當前請求,無法解析任意 URL 字串,需自行拆分。

方法二:pathinfo() (專注路徑/文件名)

<?php
$url = "https://localhost/index.php";
$info = pathinfo($url);
print_r($info);
/*
Array
(
    [dirname] => https://localhost   // 目錄部分 (注意:包含協議/主機)
    [basename] => index.php         // 文件名
    [extension] => php              // 副檔名
    [filename] => index             // 不含副檔名文件名
)
*/
?>

注意: `pathinfo()` 設計用於**本地文件路徑**,處理 URL 時 `dirname` 會包含協議主機,語義不純。適用於解析上傳文件名、本地路徑。

方法三:parse_url() (標準、強大、推薦)

<?php
$url = "https://user:pass@localhost:8080/path/script.php?name=tank&sex=1#top";
$parts = parse_url($url);
print_r($parts);
/*
Array
(
    [scheme] => http           // 協議
    [host] => localhost        // 主機名
    [port] => 8080             // 端口 (如有)
    [user] => user             // 用戶名 (如有)
    [pass] => pass             // 密碼 (如有)
    [path] => /path/script.php // 路徑
    [query] => name=tank&sex=1 // 查詢字串
    [fragment] => top          // 錨點/片段
)
*/
?>

進階:解析查詢字串為陣列 parse_str()

<?php
$query = $parts['query'] ?? '';
parse_str($query, $params);
print_r($params);
/*
Array
(
    [name] => tank
    [sex] => 1
)
*/
?>

方法四:basename() (僅取文件名含查詢/片段)

<?php
$url = "https://localhost/index.php?name=tank&sex=1#top";
echo basename($url); // "index.php?name=tank&sex=1#top"
// 注意:basename 視 URL 為路徑,不會自動去除 query/fragment
// 如需純文件名:basename(parse_url($url, PHP_URL_PATH)) -> "index.php"
?>

方法五:正則表達式 (靈活、複雜、效能較低)

<?php
$url = "https://localhost/index.php?name=tank&sex=1#top";
// 提取所有 key=value 對 (含片段)
preg_match_all('/(\w+=\w+)(#\w+)?/i', $url, $matches);
print_r($matches);
/*
[0] => Array ( [0] => name=tank, [1] => sex=1#top )
[1] => Array ( [0] => name=tank, [1] => sex=1 )
[2] => Array ( [0] => '', [1] => #top )
*/
?>

適用場景: 非標準 URL 格式、需提取特定模式、舊系統兼容。一般情況優先用 `parse_url` + `parse_str`。

綜合對比與選型建議

方法適用場景優點缺點
$_SERVER獲取當前請求信息無需解析、性能最高僅限當前請求、非標準化字串
pathinfo()本地文件路徑、上傳文件名解析簡單、專注文件名/副檔名處理 URL 語義不正確 (dirname 含協議)
parse_url()通用 URL 解析首選標準、完整、返回結構化數組、可提取特定部件 (PHP_URL_* 常量)不解析 query 為陣列 (需配合 parse_str)
basename()快速取文件名 (含參數)極簡不分離 query/fragment
正則異常格式、特定模式提取極致靈活易寫錯、效能低、維護難

最佳實踐代碼片段

<?php
function parseUrlComplete(string $url): array {
    $parts = parse_url($url);
    if ($parts === false) throw new InvalidArgumentException("Invalid URL");
    
    $result = [
        'scheme' => $parts['scheme'] ?? '',
        'host' => $parts['host'] ?? '',
        'port' => $parts['port'] ?? (($parts['scheme'] ?? '') === 'https' ? 443 : 80),
        'path' => $parts['path'] ?? '/',
        'query' => [],
        'fragment' => $parts['fragment'] ?? '',
    ];
    
    if (!empty($parts['query'])) {
        parse_str($parts['query'], $result['query']);
    }
    return $result;
}

// 用法
$url = "https://api.example.com/v1/users?page=2&limit=10#list";
$parsed = parseUrlComplete($url);
echo "Host: {$parsed['host']}\n";
echo "Page: {$parsed['query']['page']}\n";
?>
copyright © 萬盛學電腦網 all rights reserved