ulthon/uri

一个简单地解析和操作URI的类库

v1.0.1 2023-04-16 06:26 UTC

MulanPSL-2.0

• augushong

README

介绍

一个简单地解析和操作URL的类库

最低支持php7.2，通过composer安装：

composer require ulthon/uri

基本的使用方式如下，通过make静态方法或手动实例化：

use Ulthon\URI\URI;

$url = 'https://phpreturn.com/index/a6310ae8e7c561.html?name=john&[e-mail]#fragment';

$uri = URI::make($url);

// 或者

$uri = new URI($url);

实例化完成之后，就可以使用类库方法随心所欲的操作URL。

比如设置协议或域名：

use Ulthon\URI\URI;

$url = 'phpreturn.com?name=john&[e-mail]';

$newUrl = URI::make($url)
    ->scheme('http') // 修改链接为: http://phpreturn.com/index/a6310ae8e7c561.html?name=john&[e-mail]
    ->domain('doc.ulthon.com') // 修改链接为: http://doc.ulthon.com/index/a6310ae8e7c561.html?name=john&[e-mail]
    ->url();  

支持的方法如下：

• scheme()
• user()
• pass()
• host()
• port()
• path()
• query()
• fragment()

如果传入参数，就是设置，否则只是读取。比如我们要读取域名：

use Ulthon\URI\URI;

$url = 'http://phpreturn.com?name=john&[e-mail]';

$domain = URI::make($url)
    ->domain();

他还支持更复杂的用法，比如解析相对路径：

use Ulthon\URI\URI;

$url = 'http://phpreturn.com/dir/sub/file.php?name=john&[e-mail]';

$relativeUrl = '../../hello.php';

$newUrl = URI::make($url)
    ->relative($relativeUrl) // 链接修改为: http://phpreturn.com/hello.php?name=john&[e-mail]
    ->url();

在设置和获取query时，支持通过点分隔符读取多级数组，比如想要获取这样的值$_GET['post']['content']['html'] ,这时只需要使用post.content.html即可获取。

query的操作有这些：

• add() 添加get参数
• remove() 删除get参数
• set() 设置get参数
• get() 读取get参数

其中remove方法支持通过回调函数方式：

$url = 'https://phpreturn.com/?utm_source=summer-mailer&utm_medium=email&utm_campaign=summer-sale';

$newUrl = URI::make($url)->remove(function ($key, $value) {
    return (bool)preg_match('#^utm_#si', $key);
})->url();

这样一个库，很简单，却很好用，提升开发幸福感。

基于

本项目基于 https://github.com/filippotoso/uri 项目开发，增加了更灵活的用法。