forked from guzzle/guzzle
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[7.0] Added real client methods (guzzle#2529)
* Added real client methods * Added changelog entry and upgrading notes
- Loading branch information
1 parent
2c1455e
commit 8ec66c1
Showing
6 changed files
with
308 additions
and
18 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,240 @@ | ||
| <?php | ||
| namespace GuzzleHttp; | ||
|
|
||
| use GuzzleHttp\Exception\GuzzleException; | ||
| use GuzzleHttp\Promise\PromiseInterface; | ||
| use Psr\Http\Message\ResponseInterface; | ||
| use Psr\Http\Message\UriInterface; | ||
|
|
||
| /** | ||
| * Client interface for sending HTTP requests. | ||
| */ | ||
| trait ClientTrait | ||
| { | ||
| /** | ||
| * Create and send an HTTP request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string $method HTTP method. | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| abstract public function request(string $method, $uri, array $options = []): ResponseInterface; | ||
|
|
||
| /** | ||
| * Create and send an HTTP GET request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function get($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('GET', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an HTTP HEAD request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function head($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('HEAD', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an HTTP PUT request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function put($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('PUT', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an HTTP POST request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function post($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('POST', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an HTTP PATCH request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function patch($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('PATCH', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an HTTP DELETE request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| * | ||
| * @throws GuzzleException | ||
| */ | ||
| public function delete($uri, array $options = []): ResponseInterface | ||
| { | ||
| return $this->request('DELETE', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string $method HTTP method | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| abstract public function requestAsync(string $method, $uri, array $options = []): PromiseInterface; | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP GET request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function getAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('GET', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP HEAD request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function headAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('HEAD', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP PUT request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function putAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('PUT', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP POST request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function postAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('POST', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP PATCH request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function patchAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('PATCH', $uri, $options); | ||
| } | ||
|
|
||
| /** | ||
| * Create and send an asynchronous HTTP DELETE request. | ||
| * | ||
| * Use an absolute path to override the base path of the client, or a | ||
| * relative path to append to the base path of the client. The URL can | ||
| * contain the query string as well. Use an array to provide a URL | ||
| * template and additional variables to use in the URL template expansion. | ||
| * | ||
| * @param string|UriInterface $uri URI object or string. | ||
| * @param array $options Request options to apply. | ||
| */ | ||
| public function deleteAsync($uri, array $options = []): PromiseInterface | ||
| { | ||
| return $this->requestAsync('DELETE', $uri, $options); | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters