Web Request

Opensource ByJG Build Status GitHub source GitHub license GitHub release

A lightweight PSR-7 implementation and and highly customized CURL wrapper for making RESt calls.

Main Features

This class implements:

  • PSR-7 objects;
  • HttpClient customizable with partial implementation PSR-18
  • Helper to create Request instances with the most common use cases;
  • Wrapper to execute several requests in parallel;

PSR-7 Implementation and basic usage

Since the implementation follow the PSR7 implementation there is no much explanation about the usage.

The key elements are:

  • URI - Will define the URI with parameters, path, host, schema, etc
  • Request - Will set the request headers and method;
  • Response - Will receive the response header, body and status code.

More information about the PSR-7 here: https://www.php-fig.org/psr/psr-7/

The implementation to send the request object is defined by the class HttpClient. This class follow partially the PSR-18 implementation. So, once you have a Request instance defined just need to call HttpClient::sendRequest($request);

Basic Usage

$uri = \ByJG\Util\Uri::getInstanceFromString('http://www.example.com/page');
$request = \ByJG\Util\Psr7\Request::getInstance($uri);
$response = \ByJG\Util\HttpClient::getInstance()->sendRequest($request);

Passing arguments

$uri = \ByJG\Util\Uri::getInstanceFromString('http://www.example.com/page')

$request = \ByJG\Util\Psr7\Request::getInstance($uri);
$response = \ByJG\Util\HttpClient::getInstance()->sendRequest($request);

Helper Classes

The WebRequest package has Helper classes to make it easy to create Request instances for some use cases.

Passing a string payload (JSON)

$uri = \ByJG\Util\Uri::getInstanceFromString('http://www.example.com/page');
$request = \ByJG\Util\Helper\RequestJson::build(
   '{teste: "value"}'  // Support an associate array
$response = \ByJG\Util\HttpClient::getInstance()->sendRequest($request);

Create a Form Url Encoded (emulate HTTP form)

$uri = \ByJG\Util\Uri::getInstanceFromString('http://www.example.com/page');
$request = \ByJG\Util\Helper\RequestFormUrlEncoded::build(
   ["param" => "value"]
$response = \ByJG\Util\HttpClient::getInstance()->sendRequest($request);

Create a Multi Part request (upload documents)

$uri = \ByJG\Util\Uri::getInstanceFromString('http://www.example.com/page');

// Define the contents to upload using a list of MultiPartItem objects
$uploadFile = [];
$uploadFile[] = new \ByJG\Util\MultiPartItem('field1', 'value1');
$uploadFile[] = new \ByJG\Util\MultiPartItem(
    '{"key": "value2"}',
    'application/json; charset=UTF-8'
$uploadFile[] = new \ByJG\Util\MultiPartItem('field3', 'value3');

// Use the Wrapper to create the Request
$request = \ByJG\Util\Helper\RequestMultiPart::build(Uri::getInstanceFromString($uri),

// Do the request as usual
$response = \ByJG\Util\HttpClient::getInstance()->sendRequest($request);

Customizing the Http Client

The customizations options are:


$client = \ByJG\Util\HttpClient::getInstance()
    ->withNoFollowRedirect()         // HttpClient will not follow redirects (status codes 301 and 302). Default is follow 
    ->withNoSSLVerification()        // HttpClient will not validate the SSL certificate. Default is validate.
    ->withProxy($uri)                // Define a http Proxy based on the URI. 
    ->withCurlOption($key, $value)   // Set an arbitrary CURL option (use with caution)


You can use the HttpClient to do several differents requests in parallel.

To use this funcionallity you need:

  1. Create a instance of the HttpClientParallel class
  2. Add the RequestInterface instance
  3. Execute

The results will be processed as soon is ready.

Below a basic example:

// Create the instances of the requirements
$httpClient = \ByJG\Util\HttpClient::getInstance();

$onSucess = function ($response, $id) {
    // Do something with Response object

$onError = function ($error, $id) use (&$fail) {
    // Do something

// Create the HttpClientParallel
$multi = new \ByJG\Util\HttpClientParallel(

// Add the request to run in parallel
$request1 = Request::getInstance($uri1);
$request2 = Request::getInstance($uri2);
$request3 = Request::getInstance($uri3);


// Start execute and wait to finish
// The results will be get from the closure defined above. 

Mocking Http Client

The class MockClient has the same methods that HttpClient except by:

  • Do not send any request to the server;
  • You can add the expected Response object;
  • You can collect information from the CURL after submit the request.

Setting the expected response object:

$expectedResponse = new Response(200);

$mock = $this->object = new MockClient($expectedResponse);
$response = $mock->sendRequest(new Request("http://example.com"));

assertEquals($expectedResponse, $response);

Debuging the CURL options:

$expectedResponse = new Response(200);

$mock = $this->object = new MockClient($expectedResponse);
$response = $mock->sendRequest(new Request("http://example.com"));

$expectedCurlOptions = [
    CURLOPT_HEADER => true,
    CURLOPT_USERAGENT => "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)",
        'Host: localhost:8080'

assertEquals($expectedCurlOptions, $mock->getCurlConfiguration());

Other methods in the MockClient

The methods below are available after the execution of the method sendRequest():

  • getCurlConfiguration()
  • getRequestedObject()
  • getExpectedResponse()


composer install "byjg/webrequest=2.0.*"

Running Tests

Starting the server

We provide a docker-compose to enable start the test server easily.

docker-compose up -d 

Running the integration tests


Stopping the server

docker-compose down

Open source ByJG