PHP函数：parse_url

适用PHP版本

PHP 4及以上版本

函数说明

parse_url() 函数将一个完整的 URL 解析为关联数组，数组中包含了 URL 的各个组成部分（如协议、主机、端口、路径等）。这个函数对于从 URL 中提取各个部分的信息非常有用。

函数语法

parse_url(string $url, int $component = -1): array|false

参数

• url（必需）: 需要解析的完整 URL。
• component（可选）: 你希望获取的 URL 组成部分的常量值。如果省略，返回完整的数组。你可以选择以下常量来获取特定的 URL 组成部分：
  • PHP_URL_SCHEME
  • PHP_URL_HOST
  • PHP_URL_PORT
  • PHP_URL_USER
  • PHP_URL_PASS
  • PHP_URL_PATH
  • PHP_URL_QUERY
  • PHP_URL_FRAGMENT

返回值

成功时，返回一个包含 URL 各组成部分的关联数组。如果解析失败，则返回 false。

示例

parse_url("https://www.example.com:8080/path?arg=value#anchor");

示例代码的说明

上述代码将解析一个 URL 并返回如下数组：

Array
(
    [scheme] => https
    [host] => www.example.com
    [port] => 8080
    [path] => /path
    [query] => arg=value
    [fragment] => anchor
)

在这个示例中，parse_url() 将完整的 URL 拆解成多个组成部分，如协议（scheme）、主机（host）、端口（port）、路径（path）、查询字符串（query）以及锚点（fragment）。

常见错误

1. 如果 URL 格式不正确或无法解析，parse_url() 返回 false。

2. 如果给定的 URL 中没有某个组成部分，返回的数组不会包含该项。