[12.x] Introducing toUri to the Stringable Class

[devajmeireles]

With the recent addition of the Illuminate\Support\Uri class, we can interact with Uri to manipulate or retrieve specific items from the Uri. However, we often have URLs inside of text sentences that can be extracted using the Stringable class.

Here is a real-world example:

Go to {https://euhosting.com/support} for support.

We can get the URL using Stringable, like this:

$url = str($sentence)->between('{', '}')->value(); // https://euhosting.com/support

However, there are cases where we are interacting with, for example, authenticated users (clients), where we can add extra parameters to the URL to direct the user to a page where the client can be identified by URL parameters, or better yet, define for example a query parameter, such as: priority=emergency due to some special condition of the client.

With this PR, we can achieve this result by combining Stringable and Uri by the toUri method:

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

$uri = str($sentence)->between('{', '}')->toUri(); // or Str::of($sentence)->between('{', '}')->toUri();

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

return $uri->value();

In the above example, the return of value() will be:

• https://euhosting.com/support or https://euhosting.com/support?customer=cus_17DC&priority=emergency

According to the authenticated user's isVip status.