Laravel 的 toUri() 方法：通过字符串流畅地构建 URI

您是否曾经需要从文本中提取 URL 并使用查询参数动态修改它？Laravel 全新的 toUri() 方法将字符串操作转变为流畅的 URI 构建体验。

处理嵌入在文本内容中的 URL 一直以来都是一个繁琐的过程，需要使用正则表达式、字符串解析和手动构建 URL。无论您是在处理用户生成的内容、解析配置文件还是处理动态重定向，提取和修改 URI 通常都会导致代码脆弱且难以阅读。

Laravel 的 toUri() 方法巧妙地弥补了这一缺陷，它将字符串内容转换为支持流畅方法链的强大 URI 对象。这种方法将 Laravel 优秀的字符串助手与强大的 URI 操作功能相结合，为 URL 处理任务创造了无缝的开发者体验。

真实示例

设想一个客户支持系统，它需要从模板中提取支持 URL，并根据用户的账户状态动态添加用户特定的参数：

$sentence = 'Go to {https://euhosting.com/support} for support.';

$uri = str($sentence)->between('{', '}')->toUri();
if (auth()->user()->isVip()) {
    $uri = $uri->withQuery(['customer' => auth()->user()->publicId()])
              ->withQuery(['priority' => 'emergency']);
}

$finalUrl = $uri->value();

// Result: https://euhosting.com/support?customer=12345&priority=emergency
$templateUrl = 'Visit {https://api.example.com/v1/users} to manage your account.';
$apiUri = str($templateUrl)
    ->between('{', '}')
    ->toUri()
    ->withQuery(['token' => session('api_token')])
    ->withQuery(['format' => 'json'])
    ->withFragment('profile');

echo $apiUri->value();
// Result: https://api.example.com/v1/users?token=abc123&format=json#profile

此模式对于电子邮件模板处理、配置管理、API 端点构建以及任何需要从文本解析 URL 并以编程方式修改 URL 的场景都非常有用。流畅的接口使转换过程具有自文档性，并消除了 URL 操作中通常需要的容易出错的字符串连接。

toUri() 方法还可以与 Laravel 现有的字符串助手无缝集成，允许您将多个操作链接在一起。这可以创建可读且易于维护的代码，清晰地表达 URL 处理逻辑的意图。