php-extended/php-http-client-blocklist

A psr-18 compliant middleware client that handles domain-based blocklists

7.0.6 2024-07-31 13:50 UTC

README

A psr-18 compliant middleware client that handles domain-based blocklists

coverage build status

Installation

The installation of this library is made via composer and the autoloading of all classes of this library is made through their autoloader.

  • Download composer.phar from their website.
  • Then run the following command to install this library as dependency :
  • php composer.phar php-extended/php-http-client-blocklist ^7

Basic Usage

This library is to make a man in the middle for http request and response and deny all the requests that does to unacceptable or unsafe domains.


/* @var $client  \Psr\Http\Client\ClientInterface   */ // psr-18
/* @var $request \Psr\Http\Message\RequestInterface */ // psr-7
/* @var $responseFactory \Psr\Http\Message\ResponseFactoryInterface */ // psr-17
/* @var $blocklist \PhpExtended\Blocklist\BlocklistInterface */

$client = new BlocklistClient($client, $responseFactory, $blocklist);
$response = $client->sendRequest($request);

/* @var $response \Psr\Http\Message\ResponseInterface */
// this returns a 403 if the request was denied
// this forwards the request to the real client if allowed

License

MIT (See license file).