parse_url 返回結果為NULL 與FALSE 的區別

gitbox 2025-05-26

在PHP 中， parse_url函數是一個非常實用的工具，用於解析URL 並返回其組成部分，比如協議（scheme）、主機名（host）、路徑（path）等。函數的基本用法如下：

 $url = "https://gitbox.net/path?query=1";
$parts = parse_url($url);
print_r($parts);

這段代碼會輸出URL 的各個組成部分，如：

 Array
(
    [scheme] => https
    [host] => gitbox.net
    [path] => /path
    [query] => query=1
)

不過，有時候你可能會遇到parse_url返回NULL或FALSE的情況，這時就會產生疑惑：它們之間有什麼區別？本文將詳細說明這兩種返回值的含義及適用場景。

parse_url 返回FALSE

在PHP 7.3 及更早版本中，如果傳入的URL 格式極其錯誤， parse_url會返回FALSE ，表示解析失敗。

 $url = "ht!tp:::/invalid-url";
$result = parse_url($url);
var_dump($result);  // bool(false)

這裡的URL 格式明顯不符合規範，函數無法正常解析，因此返回FALSE 。

總結：

返回FALSE通常表示傳入的字符串無法被識別為合法的URL 或URI。
可能是因為字符串包含不允許的字符或者格式錯誤。

parse_url 返回NULL

實際上， parse_url函數在官方文檔中並沒有明確說明會返回NULL 。但是在一些特定情況下，比如調用parse_url並傳入空字符串或者非字符串類型，可能會出現NULL 。

 $url = "";
$result = parse_url($url);
var_dump($result);  // NULL 或空數組，取決於 PHP 版本

另外，如果請求解析URL 的某個特定部分，而這個部分在URL 中不存在時，返回值對應部分會是NULL 。

 $url = "https://gitbox.net";
$host = parse_url($url, PHP_URL_HOST);
var_dump($host);  // string(9) "gitbox.net"

$path = parse_url($url, PHP_URL_PATH);
var_dump($path);  // NULL，因為 URL 中沒有路徑部分

這裡返回的NULL是針對具體部分的結果，表示該部分不存在。

總結：

返回NULL可能是請求某個URL 組成部分時，該部分不存在。
也可能是傳入了空字符串或不規範參數，具體表現視PHP 版本而定。

小結與建議

返回值	含義	典型場景
FALSE	URL 格式錯誤，無法解析	輸入字符串包含非法字符或結構異常
NULL	請求的URL 組成部分不存在或空字符串	請求不存在的部分，或傳入空字符串

在實際開發中，建議：

先檢查URL 字符串是否為空或格式明顯錯誤，避免傳入不合法的字符串。
調用parse_url時，如果只需要部分字段，務必判斷返回結果是否為NULL ，避免程序報錯。
在解析前，可以使用正則或過濾函數初步校驗URL 結構，提升程序健壯性。

例如：

 $url = "https://gitbox.net";

$host = parse_url($url, PHP_URL_HOST);
if ($host === null) {
    echo "URL 中沒有 host 部分\n";
} else {
    echo "Host: $host\n";
}

通過合理的判斷，可以避免因NULL或FALSE導致的邏輯錯誤。

parse_url