fyre/uri

URI 库。

v3.0.11 2024-06-29 02:00 UTC

README

FyreURI 是一个免费、开源的不可变 URI 库,适用于 PHP

目录

安装

使用 Composer

composer require fyre/uri

在 PHP 中

use Fyre\Http\Uri;

URI 创建

  • $uriString 是表示 URI 的字符串。
$uri = new Uri($uriString);

或者,您可以使用 fromString 方法进行更方便的链式调用。

$uri = Uri::fromString($uriString);

方法

添加查询参数

添加查询参数。

  • $key 是表示查询键的字符串。
  • $value 是查询值。
$newUri = $uri->addQuery($key, $value);

排除查询参数

删除查询参数。

  • $keys 是包含要删除的查询参数的数组。
$newUri = $uri->exceptQuery($keys);

获取权限

获取 URI 权限字符串。

$authority = $uri->getAuthority();

获取片段

获取 URI 片段。

$fragment = $uri->getFragment();

获取主机

获取 URI 主机。

$host = $uri->getHost();

获取路径

获取 URI 路径。

$path = $uri->getPath();

获取端口

获取 URI 端口。

$port = $uri->getPort();

获取查询

获取 URI 查询数组。

$query = $uri->getQuery();

获取查询字符串

获取 URI 查询字符串。

$query = $uri->getQueryString();

获取方案

获取 URI 方案。

$scheme = $uri->getScheme();

获取段

获取指定的 URI 段。

  • $segment 是表示段索引的数字。
$part = $uri->getSegment($segment);

获取段

获取 URI 段。

$segments = $uri->getSegments();

获取总段数

获取 URI 段的数量。

$segmentCount = $uri->getTotalSegments();

获取 URI

获取 URI 字符串。

$uriString = $uri->getUri();

获取用户信息

获取用户信息字符串。

$userInfo = $uri->getUserInfo();

仅查询

过滤查询参数。

  • $keys 是包含要保留的查询参数的数组。
$newUri = $uri->onlyQuery($keys);

设置权限

设置 URI 权限字符串。

  • $authority 是表示权限的字符串。
$newUri = $uri->setAuthority($authority);

设置片段

设置 URI 片段。

  • $fragment 是表示片段的字符串。
$newUri = $uri->setFragment($fragment);

设置主机

设置 URI 主机。

  • $host 是表示主机的字符串。
$newUri = $uri->setHost($host);

设置路径

设置 URI 路径。

  • $path 是表示路径的字符串。
$newUri = $uri->setPath($path);

设置端口

获取 URI 端口。

  • $port 是表示端口的数字。
$newUri = $uri->setPort($port);

设置查询

获取 URI 查询数组。

  • $query 是包含查询参数的数组。
$newUri = $uri->setQuery($query);

设置查询字符串

获取 URI 查询字符串。

  • $query 是表示查询参数的字符串。
$newUri = $uri->setQueryString($query);

设置方案

获取 URI 方案。

  • $scheme 是表示方案的字符串。
$newUri = $uri->setScheme($scheme);

设置用户信息

获取用户信息字符串。

  • $username 是表示用户名的字符串。
  • $password 是表示密码的字符串,默认为 ""
$newUri = $uri->setUserInfo($username, $password);