ralphschindler / phetch
A Nice HTTP Client For PHP
Requires
- php: >=7.2
Requires (Dev)
- phpunit/phpunit: ^9.0
This package is auto-updated.
Last update: 2024-11-11 04:03:21 UTC
README
Phetch is the missing 80% use case HTTP client for PHP. Phetch did not invent anything new, rather it is borrowing and building these ideas & desires:
- API is natural, comfortable, and pleasant to use
- A Zttp like client without the Guzzle dependency
- As approachable as HTTPie
- Json by default / Sensible defaults
- Lightweight wrapper of PHP stream (http, ssl) functionality
- Has shallow stack traces
- Service container friendly
Install
$ composer require ralphschindler/phetch
Usage
GET With Query Parameters
// simple call to the Github API $resp = Phetch\Phetch::withBearerAuth('abcdefghijklmnopqrstuvwxyz0123456789') ->get('https://api.github.com/repos/ralphschindler/phetch/issues', ['state' => 'all']); $resp->json(); // the response body as an array
POST with body
$response = Phetch\Phetch::request()->post('https://api.github.com/repos/ralphschindler/phetch/issues', [ 'title' => 'My Issue', 'body' => 'This is the body to my issue', ]);
PATCH
$response = Phetch\Phetch::request()->patch('https://api.github.com/repos/ralphschindler/phetch/issues/1', [ 'title' => 'My Issue Updated Title!', ]);
DELETE, with special headers at call time
// locking github issues requires a special accept header $response = Phetch\Phetch::request()->delete('https://api.github.com/repos/ralphschindler/phetch/issues/1/lock', ['headers' => ['Accept' => 'application/vnd.github.sailor-v-preview+json']] );
Other special helper methods
Setting a base url for repeated calls at the same web service:
$req = Phetch\Phetch::withBaseUrl('https://api.github.com'); $respGet = $request->get(...); $respPatch = $request->patch(...);
Without verifying the SSL Certificate
$page = Phetch\Phetch::withoutVerifying()->get('https://IDidntUpdateMyCert.org');
Not following redirects
$page = Phetch\Phetch::withoutRedirecting()->get('https://AUrlThatRedirects.com/place');
Basic Authentication
$page = Phetch\Phetch::withBasicAuth($username, $password)->get('https://AUrlThatRedirects.com/place');
Bearer authentication
$page = Phetch\Phetch::withBearerAuth($token)->get('https://AUrlThatRedirects.com/place');
As A Service Inside An Application
Often times you may want to pre-configure a request to be used with shared settings in different contexts. Additionally, you may want to build a web-service specific client.
Setup the service
Creating a service allows you to configure and share a PendingRequest
object
with as much boilerplate as necessary for your app to talk to a particular
service. ($container
is assumed to be some kind of service container.)
$githubWebService = Phetch\Phetch::createService(function ($pendingRequestPrototype) { $pendingRequestPrototype->withHeaders(['User-Agent' => 'My Applications Http Client v1.0.0']) ->withBaseUrl('https://api.github.com') ->withBearerAuth('abcdefghijklmnopqrstuvwxyz0123456789'); }); $container->share('github-web-service', $githubWebService);
Use the service somewhere in your application code (controller, service classes, etc)
The PhetchService
now contains your prototypical PendingRequest
object that is preconfigured for use everywhere in your application. Each time
you call $service->request()
, you will get a cloned/fresh PendingRequest
object that you can interact with. State changes to this new object will
not affect the service's pre-configured object:
/** @var \Phetch\PhetchService $github */ $github = $container->get('github-web-service'); // request() will always produce a fresh & pre-configured \Phetch\PendingRequest $resp = $github->request() ->get('/repos/ralphschindler/phetch/issues', ['state' => 'closed']);
Todo
- httpie command parsing
- command line phetch client
- curl adapter (good open source contribution would be nice!)