[9.x] Add uri templates to Http client

[jbrooksuk]

This PR introduces the ability to use URI templates on the Http client. We pull in guzzlehttp/uri-templates which follows the spec at https://www.rfc-editor.org/rfc/rfc6570

Http::withUrlParameters([
    'endpoint' => 'https://laravel.com',
    'page' => 'docs',
    'version' => '9.x',
    'thing' => 'validation',
])->get('{+endpoint}/{page}/{version}/{thing}');

// https://laravel.com/docs/9.x/validation

This is using guzzlehttp/uri-template behind the scenes, which provides a much wider set of support features when expanding templates.

[jbrooksuk]

The other methods were already type-hinted, so I updated these too. Let me know if this is wrong though.

[mathieutu]

Isn't it the same as writing

Suggested change

	return tap($this, function () use ($parameters) {
	$this->urlParameters = $parameters;
	});
	$this->urlParameters = $parameters;
	return $this;

Or am I missing something?

[timacdonald]

This is sick 🔥

[tvup]

@jbrooksuk
What will this do if you have a url like
http://endpoint.top/model?filter={"PriceType":"Expensive"}
?

[jbrooksuk]

@tvup good question, with multiple answers.

1. If you're not composing a Http request with URL parameters, then nothing different happens.
2. withUrlParameters will only expand on defined parameters. Since you're not doing anything with URL parameters, nothing changes.
3. You should really move the filter into the second argument, Http::get('http://endpoint.top/model', ['filter' => json_encode(["PriceType" => "Expensive"])]);.

[GrahamCampbell]

You should not include the question mark on the end there, in bullet v3. It is added for you.

Http::get('http://endpoint.top/model', ['filter' => json_encode(['PriceType' => 'Expensive'])]);

[jbrooksuk]

Whoops, typo!