voku/httpful

A Readable, Chainable, REST friendly, PHP HTTP Client

Saturday, December 23, 2017
by voku
Repository
2 Watchers
1 Stars
17,873 Installations

PHP
1 Dependents
0 Suggesters
296 Forks
0 Open issues
34 Versions
10 % Grown

The README.md

, _(*1)

📯 Httpful

Forked some years ago from nategood/httpful + added support for parallel request and implemented many PSR Interfaces: A Chainable, REST Friendly Wrapper for cURL with many "PSR-HTTP" implemented interfaces., _(*2)

Features, _(*3)

Readable HTTP Method Support (GET, PUT, POST, DELETE, HEAD, PATCH and OPTIONS)
Custom Headers
Automatic "Smart" Parsing
Automatic Payload Serialization
Basic Auth
Client Side Certificate Auth (SSL)
Request "Download"
Request "Templates"
Parallel Request (via curl_multi)
PSR-3: Logger Interface
PSR-7: HTTP Message Interface
PSR-17: HTTP Factory Interface
PSR-18: HTTP Client Interface

Examples

<?php

// Make a request to the GitHub API.

$uri = 'https://api.github.com/users/voku';
$response = \Httpful\Client::get($uri, null, \Httpful\Mime::JSON);

echo $response->getBody()->name . ' joined GitHub on ' . date('M jS Y', strtotime($response->getBody()->created_at)) . "\n";

<?php

// Make a request to the GitHub API with a custom
// header of "X-Foo-Header: Just as a demo".

$uri = 'https://api.github.com/users/voku';
$response = \Httpful\Client::get_request($uri)->withAddedHeader('X-Foo-Header', 'Just as a demo')
                                              ->expectsJson()
                                              ->send();

$result = $response->getRawBody();

echo $result['name'] . ' joined GitHub on ' . \date('M jS Y', \strtotime($result['created_at'])) . "\n";

<?php

// BasicAuth example with MultiCurl for async requests.

/** @var \Httpful\Response[] $results */
$results = [];
$multi = new \Httpful\ClientMulti(
    static function (\Httpful\Response $response, \Httpful\Request $request) use (&$results) {
        $results[] = $response;
    }
);

$request = (new \Httpful\Request(\Httpful\Http::GET))
    ->withUriFromString('https://postman-echo.com/basic-auth')
    ->withBasicAuth('postman', 'password');

$multi->add_request($request);
// $multi->add_request(...); // add more calls here

$multi->start();

// DEBUG
//print_r($results);

Installation

composer require voku/httpful

Handlers

We can override the default parser configuration options be registering a parser with different configuration options for a particular mime type, _(*4)

Example: setting a namespace for the XMLHandler parser, _(*5)

$conf = ['namespace' => 'http://example.com'];
\Httpful\Setup::registerMimeHandler(\Httpful\Mime::XML, new \Httpful\Handlers\XmlMimeHandler($conf));

Handlers are simple classes that are used to parse response bodies and serialize request payloads. All Handlers must implement the MimeHandlerInterface interface and implement two methods: serialize($payload) and parse($response). Let's build a very basic Handler to register for the text/csv mime type., _(*6)

<?php

class SimpleCsvMimeHandler extends \Httpful\Handlers\DefaultMimeHandler
{
    /**
     * Takes a response body, and turns it into
     * a two dimensional array.
     *
     * @param string $body
     *
     * @return array
     */
    public function parse($body)
    {
        return \str_getcsv($body);
    }

    /**
     * Takes a two dimensional array and turns it
     * into a serialized string to include as the
     * body of a request
     *
     * @param mixed $payload
     *
     * @return string
     */
    public function serialize($payload)
    {
        // init
        $serialized = '';

        foreach ($payload as $line) {
            $serialized .= '"' . \implode('","', $line) . '"' . "\n";
        }

        return $serialized;
    }
}

\Httpful\Setup::registerMimeHandler(\Httpful\Mime::CSV, new SimpleCsvMimeHandler());

Finally, you must register this handler for a particular mime type., _(*7)

\Httpful\Setup::register(Mime::CSV, new SimpleCsvHandler());

After this registering the handler in your source code, by default, any responses with a mime type of text/csv should be parsed by this handler., _(*8)

The Versions

23/12 2017

dev-master

9999999-dev http://github.com/voku/httpful

A Readable, Chainable, REST friendly, PHP HTTP Client

library httpful

A Readable, Chainable, REST friendly, PHP HTTP Client

voku/httpful

The README.md

📯 Httpful

Examples

Installation

Handlers

The Versions

dev-master

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.4.0

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

dev-analysis-873adN

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.3.0

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.2.27

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.2.26

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.2.25

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.2.24

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

v0.2.23

The Requires

The Development Requires

by Nate Good

by Lars Moelleken

dev-dev

The Requires

The Development Requires

by Nate Good

0.2.20

The Requires

The Development Requires

by Nate Good

0.2.19

The Requires

The Development Requires

by Nate Good

0.2.17

The Requires

The Development Requires

by Nate Good

0.2.16

The Requires

The Development Requires

by Nate Good

0.2.13

The Requires

The Development Requires

by Nate Good

dev-r0.3.0

The Requires