mirror of
https://codeberg.org/reflect/reflect-client-php.git
synced 2025-09-14 10:03:41 +02:00
Compare commits
No commits in common. "master" and "3.0.3" have entirely different histories.
2 changed files with 22 additions and 62 deletions
16
README.md
16
README.md
|
@ -137,19 +137,3 @@ Example:
|
||||||
```php
|
```php
|
||||||
$client->call("my/endpoint")->params(["foo" => "bar"])->delete();
|
$client->call("my/endpoint")->params(["foo" => "bar"])->delete();
|
||||||
```
|
```
|
||||||
|
|
||||||
### `OPTIONS` Request
|
|
||||||
|
|
||||||
Make an `OPTIONS` request by chaining `options()` at the end of a method chain. This method will return a `Reflect\Response` object.
|
|
||||||
|
|
||||||
Use this method to query Reflect for available request methods.
|
|
||||||
|
|
||||||
```php
|
|
||||||
Client->options(): Reflect\Response;
|
|
||||||
```
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```php
|
|
||||||
$client->call("my/endpoint"))->options();
|
|
||||||
```
|
|
||||||
|
|
|
@ -9,17 +9,15 @@
|
||||||
require_once "Response.php";
|
require_once "Response.php";
|
||||||
|
|
||||||
class Client {
|
class Client {
|
||||||
private string $params;
|
|
||||||
private string $endpoint;
|
|
||||||
private array $headers = [];
|
|
||||||
private ?array $payload = null;
|
|
||||||
|
|
||||||
protected ?string $key;
|
protected ?string $key;
|
||||||
protected string $base_url;
|
protected string $base_url;
|
||||||
protected bool $https_verify_peer;
|
protected bool $https_verify_peer;
|
||||||
|
|
||||||
|
protected string $endpoint;
|
||||||
|
protected string $params;
|
||||||
|
|
||||||
public function __construct(string $base_url, string $key = null, bool $verify_peer = true) {
|
public function __construct(string $base_url, string $key = null, bool $verify_peer = true) {
|
||||||
// Set optional API key and Authorization header
|
// Optional API key
|
||||||
$this->key = $key;
|
$this->key = $key;
|
||||||
|
|
||||||
// Append tailing "/" if absent
|
// Append tailing "/" if absent
|
||||||
|
@ -36,25 +34,27 @@
|
||||||
// ----
|
// ----
|
||||||
|
|
||||||
// Construct stream_context_create() compatible header string
|
// Construct stream_context_create() compatible header string
|
||||||
private function get_headers(): string {
|
private function http_headers(): string {
|
||||||
// Set Authorization header if an API key is used
|
$headers = ["Content-Type: application/json"];
|
||||||
if ($this->key) {
|
|
||||||
$this->headers["Authorization"] = "Bearer {$this->key}";
|
// Append Authentication header if API key is provided
|
||||||
|
if (!empty($this->key)) {
|
||||||
|
$headers[] = "Authorization: Bearer {$this->key}";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Construct HTTP headers string from array
|
// Append new line chars to each header
|
||||||
$headers = array_map(fn(string $k, string $v): string => "{$k}: {$v}\r\n", array_keys($this->headers), array_values($this->headers));
|
$headers = array_map(fn($header): string => $header . "\r\n", $headers);
|
||||||
return implode("", $headers);
|
return implode("", $headers);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Make request and return response over HTTP
|
// Make request and return response over HTTP
|
||||||
private function http_call(Method $method): array {
|
private function http_call(Method $method, array $payload = null): array {
|
||||||
$context = stream_context_create([
|
$context = stream_context_create([
|
||||||
"http" => [
|
"http" => [
|
||||||
"header" => $this->get_headers(),
|
"header" => $this->http_headers(),
|
||||||
"method" => $method->name,
|
"method" => $method->name,
|
||||||
"ignore_errors" => true,
|
"ignore_errors" => true,
|
||||||
"content" => !empty($this->payload) ? json_encode($this->payload) : ""
|
"content" => !empty($payload) ? json_encode($payload) : ""
|
||||||
],
|
],
|
||||||
"ssl" => [
|
"ssl" => [
|
||||||
"verify_peer" => $this->https_verify_peer,
|
"verify_peer" => $this->https_verify_peer,
|
||||||
|
@ -73,20 +73,6 @@
|
||||||
return [$resp, $resp_code];
|
return [$resp, $resp_code];
|
||||||
}
|
}
|
||||||
|
|
||||||
// Set request body to be JSON-stringified
|
|
||||||
private function set_request_body(?array $payload = null): self {
|
|
||||||
// Unset request body if no payload defined
|
|
||||||
if (empty($payload)) {
|
|
||||||
$this->payload = null;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
$this->headers["Content-Type"] = "application/json";
|
|
||||||
|
|
||||||
$this->payload = $payload;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ----
|
// ----
|
||||||
|
|
||||||
// Construct URL search parameters from array if set
|
// Construct URL search parameters from array if set
|
||||||
|
@ -102,10 +88,8 @@
|
||||||
? $endpoint
|
? $endpoint
|
||||||
: substr($endpoint, 1, strlen($endpoint) - 1);
|
: substr($endpoint, 1, strlen($endpoint) - 1);
|
||||||
|
|
||||||
// Reset initial values
|
// Reset search parameters
|
||||||
$this->params();
|
$this->params();
|
||||||
$this->headers = [];
|
|
||||||
$this->set_request_body();
|
|
||||||
|
|
||||||
return $this;
|
return $this;
|
||||||
}
|
}
|
||||||
|
@ -118,26 +102,18 @@
|
||||||
}
|
}
|
||||||
|
|
||||||
public function patch(?array $payload = []): Response {
|
public function patch(?array $payload = []): Response {
|
||||||
$this->set_request_body($payload);
|
return new Response(...$this->http_call(Method::PATCH, $payload));
|
||||||
return new Response(...$this->http_call(Method::PATCH));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public function put(?array $payload = []): Response {
|
public function put(?array $payload = []): Response {
|
||||||
$this->set_request_body($payload);
|
return new Response(...$this->http_call(Method::PUT, $payload));
|
||||||
return new Response(...$this->http_call(Method::PUT));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public function post(?array $payload = []): Response {
|
public function post(?array $payload = []): Response {
|
||||||
$this->set_request_body($payload);
|
return new Response(...$this->http_call(Method::POST, $payload));
|
||||||
return new Response(...$this->http_call(Method::POST));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public function delete(?array $payload = []): Response {
|
public function delete(?array $payload = []): Response {
|
||||||
$this->set_request_body($payload);
|
return new Response(...$this->http_call(Method::DELETE, $payload));
|
||||||
return new Response(...$this->http_call(Method::DELETE));
|
|
||||||
}
|
}
|
||||||
|
}
|
||||||
public function options(): Response {
|
|
||||||
return new Response(...$this->http_call(Method::OPTIONS));
|
|
||||||
}
|
|
||||||
}
|
|
Loading…
Add table
Reference in a new issue