PHP URL 类用于解析、构造、标准化和编码 URL - 但就像 JavaScript 一样

dev-master 2023-08-15 15:56 UTC

This package is auto-updated.

Last update: 2024-09-15 18:56:14 UTC


README

URL 类用于解析、构造、标准化和编码 URL。它通过提供属性,允许您轻松读取和修改 URL 的组件。

通常通过在调用其构造函数时指定 URL 作为字符串,或提供相对 URL 和基础 URL 来创建新的 URL 对象。然后可以轻松地读取解析后的 URL 组件或修改 URL。

实例属性

hash

包含 URL 片段标识符的字符串。

host

包含域名(即主机名)的字符串,后跟(如果指定了端口号)一个 ':' 和 URL 的端口号。

hostname

包含 URL 的域名的字符串。

href

返回包含整个 URL 的字符串的字符串化程序。

origin

返回包含 URL 的来源的字符串,即其方案、域名和端口号。

password

包含在域名之前指定的密码的字符串。

pathname

包含一个初始 '/' 后跟 URL 的路径的字符串,不包括查询字符串或片段。

port

包含 URL 的端口号的字符串。

protocol

包含 URL 的协议方案的字符串。

search

指示 URL 的参数字符串的字符串;如果有任何参数,则此字符串包含所有这些参数。

searchParams

一个 URLSearchParams 对象,可用于访问搜索中找到的各个查询参数。

username

包含在域名之前指定的用户名的字符串。

实例方法

toString()

返回包含整个 URL 的字符串。它是 URL.href 的同义词,尽管不能用于修改值。

toJSON()

返回包含 URL 对象序列化版本的 JSON 字符串。

URLSearchParams

URLSearchParams 接口定义了用于处理 URL 查询字符串的实用方法。

实例属性

size

指示搜索参数条目的总数。

实例方法

append(string $name, string | int | bool $value)

将指定的键/值对作为新的搜索参数追加。

delete(string $name, null | string | int | bool $value = null)

从所有搜索参数列表中删除与名称匹配的搜索参数,以及可选的值。

entries()

返回一个迭代器,允许以与查询字符串中出现的顺序相同的顺序遍历此对象中包含的所有键/值对。

get(string $name)

返回与给定搜索参数关联的第一个值。

has(string $name)

返回一个布尔值,指示是否存在给定的参数或参数和值对。

keys()

返回一个迭代器,允许遍历此对象中包含的所有键/值对的键。

set(string $name, string | int | bool $value)

将给定搜索参数的值设置为给定的值。如果有多个值,则删除其他值。

toString()

返回一个包含适合在 URL 中使用的查询字符串的字符串。

values()

返回一个迭代器,允许遍历此对象中包含的所有键/值对的值。