juststeveking/http-slim

A slim psr compliant http client to provide better interoperability.

v2.1.0 2021-08-27 11:05 UTC

Requires

• php: ^8.0
• ext-json: *
• php-http/client-common: ^2.4
• php-http/discovery: ^1.14
• php-http/mock-client: ^1.5
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• thecodingmachine/safe: ^1.3

Requires (Dev)

• nyholm/psr7: ^1.3
• pestphp/pest: ^1.17
• pestphp/pest-plugin-parallel: ^0.3.0
• php-parallel-lint/php-parallel-lint: ^1.2
• phpspec/prophecy-phpunit: ^2.0
• phpunit/phpunit: ^9.1
• squizlabs/php_codesniffer: ^3.5
• symfony/http-client: ^5.0
• symfony/var-dumper: ^5.0
• thecodingmachine/phpstan-safe-rule: ^1.0

Provides

• php-http/client-implementation: 1.0
• psr/http-client-implementation: 1.0

MIT

• Steve McDougall

• psr-7
• http-client
• psr-17
• psr-18

README

The purpose of this package is to create an interoperable http client implementation allowing a "bring you own packages" approach to connection to 3rd party services.

The main goal of this package is to adhere to the following PSRs:

• PSR-18 - HTTP Client
• PSR-17 - HTTP Factories
• PSR-7 - HTTP Message Interface

Installation

Using composer:

$ composer require juststeveking/http-slim

You are then free to use it as needed within your projects.

Next steps

The next step is to install a compliant package to do the request itself.

A few packages that are recommended:

• Guzzle
• Symfony HttpClient
• A great PSR implementation with factories to adhere to PSR-18 fully

Usage

Once you have installed a PSR-18 package and a PSR-17 package we do not need to do anything else. This package support HTTP Autodiscovery for your PSR compliant Client and Request factories. However, should you choose to inject you can do!

<?php

declare(strict_types=1);

use JustSteveKing\HttpSlim\HttpClient;
use Symfony\Component\HttpClient\Psr18Client;

// Injecting Clients: 
$httpClient = HttpClient::build(
    clientInterface: new Psr18Client(),
    requestFactory: new Psr18Client(),
    streamFactory: new Psr18Client(),
);

// Using HTTP Auto-discovery
$httpClient = HttpClient::build();


// perform a get request
$httpClient->get(
    uri: 'https://api.example.com/v1/resource',
);

// perform a post request
$httpClient->post(
    uri: 'https://api.example.com/v1/resource',
    body: ['foo' => 'bar'],
);

// perform a put request
$httpClient->put(
    uri: 'https://api.example.com/v1/resource/identifier',
    body: ['foo' => 'bar'],
);

// perform a patch request
$httpClient->patch(
    uri: 'https://api.example.com/v1/resource/identifier',
    body: ['foo' => 'bar'],
);

// perform a delete request
$httpClient->delete(
    uri: 'https://api.example.com/v1/resource/identifier',
);

// perform an options request
$httpClient->options(
    uri: 'https://api.example.com/v1/resource/identifier',
    headers: ['X-OPTIONAL' => 'headers'],
);

// Adding Plugins
$httpClient->addPlugin(
    plugin: new \Http\Client\Common\Plugin\HeaderDefaultsPlugin(
        headers: ['Content-Type' => 'application/json'],
    ),
);

Tests

There is a composer script available to run the tests:

$ composer run preflight:test

However, if you are unable to run this please use the following command:

$ ./vendor/bin/phpunit --testdox

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.