PHP parse_url() 函數深度解析：URL 拆解與組件提取

函數簡介

parse_url(string $url): array|false 用於解析 URL 字串，回傳包含各組件的關聯陣列。它不驗證 URL 合法性，僅進行字串分解；不完整的 URL 也會嘗試解析。支援 PHP 4、PHP 5 及所有後續版本。

回傳值結構

成功時回傳關聯陣列，可能包含以下鍵值（至少有一個）：

若 URL 嚴重不合法，回傳 false 並觸發 E_WARNING。

實戰範例

<?php
$url = 'https://username:password@hostname/path?arg=value#anchor';
print_r(parse_url($url));
?>

輸出結果：

Array
(
    [scheme] => http
    [host] => hostname
    [user] => username
    [pass] => password
    [path] => /path
    [query] => arg=value
    [fragment] => anchor
)

重要限制與注意事項

1. 不支援相對 URL：如 ../path/file.php 會解析失敗。
2. 專為 URL 設計，非通用 URI：但為相容歷史原因，file:// 協議允許三斜線（file:///path），其他協議不允許。
3. 查詢字串不會自動解碼：回傳的 query 為原始字串，需搭配 parse_str() 轉為陣列。
4. PHP 8.1+ 棄用警告：傳入非字串會拋出 TypeError，請確保參數型別正確。

進階應用：搭配 parse_str() 解析查詢參數

<?php
$url = 'https://api.example.com/search?q=php+parse_url&page=2&sort=desc';
$parts = parse_url($url);
parse_str($parts['query'], $queryArray);
print_r($queryArray);
/*
Array
(
    [q] => php parse_url
    [page] => 2
    [sort] => desc
)
*/
?>

常見使用場景

• 從完整 URL 提取域名進行白名單驗證
• 重寫路由系統中解析請求 URL
• 爬蟲提取連結的 host、path 歸類
• OAuth 回調 URL 驗證與參數提取

總結

parse_url() 是 PHP 處理 URL 的基石函數，輕量、快速、無依賴。掌握其回傳結構與限制，能避免手動正則解析的錯誤與效能損耗。記住：它只負責「拆解」，驗證與進一步處理需自行實作。