README

Component to make HTTP requests and test RESTful APIs

How to install

composer require fgsl/rest

How to instance

use Fgsl\Rest\Rest;

$rest = new Rest();

Available methods

General advice: The argument $verbose is for debugging. It enables output (a lot of output) for the commands.

• doGet

/**
     * Method to make a HTTP GET request
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     */
    public function doGet($headers,$url,$expectedCode, $data = [],$verbose=false)

• doPost

    /**
     * Method to make a HTTP POST request
     * @param $data array
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     * @param $verbose boolean
     * @param $json boolean
     * @param $encodeJson boolean
     */
    public function doPost(array $data, array $headers, string $url, $expectedCode, bool $verbose=false, bool $json=false, bool $encodeJson=false)

The argument $json, when it is true, enables the header Content-Type: application/json.

The argument $encodeJson, when it is true, converts $data to string using json_encode() function. Otherwise, the array is converted in a string with the fields as pairs key=value united by &.

• doPut

    /**
     * Method to make a HTTP PUT request
     * @param $data array
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     * @param $verbose boolean
     * @param $json boolean
     * @param $encodeJson boolean
     */
    public function doPut(array $data, array $headers, string $url, $expectedCode, bool $verbose=false, bool $json=false, bool $encodeJson=false) {

• doDelete

/**
     * Method to make a HTTP DELETE request
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     * @param $data array
     * @param $verbose boolean
     */
    public function doDelete($headers,$url,$expectedCode, $data = [],$verbose=false)

• doPatch

/**
     * Method to make a HTTP PATCH request
     * @param $data array
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     */
    public function doPatch($data,$headers,$url,$expectedCode, $verbose=false)

• doDelete

/**
     * Method to make a HTTP PATCH request
     * @param $data array
     * @param $headers array
     * @param $url string
     * @param $expectedCode string | integer | array
     */
    public function doPatch($data,$headers,$url,$expectedCode, $verbose=false)

Examples

Below we have some examples about how to use the Rest class.

We have used a page of the Brazilian National Observatory for GET method.

We have used Reqres for POST, PATCH and DELETE methods.

Testing a HTTP GET request

public function testGet()
    {
        $rest = new Rest();
        $this->assertTrue(is_object($rest));
        
        @$response = $rest->doGet([],'http://www.horalegalbrasil.mct.on.br/SincronismoPublico.html',200);
        
        $this->assertStringContainsString('Sincronismo', $response);

        @$response = $rest->doGet([],'http://www.horalegalbrasil.mct.on.br/SincronismoPublico.html',500);
        
        $this->assertEquals(1,count($rest->requestErrors));

        $this->assertEquals(2,$rest->requestCounter);
    }

Testing a HTTP POST request

public function testPost()
    {
        $rest = new Rest();

        $data = [
            'name' => 'morpheus',
            'job' => 'leader'
        ];
        
        @$response = $rest->doPost($data, [],'https://reqres.in/api/users',201);
        
        $this->assertStringContainsString('createdAt', $response);
    }

Testing a HTTP PUT request

    public function testPut()
    {
        $rest = new Rest();

        $data = [
            'name' => 'morpheus',
            'job' => 'general'
        ];
        
        @$response = $rest->doPut($data, [],'https://reqres.in/api/users/2',201);
        
        $this->assertStringContainsString('updatedAt', $response);
    }

Testing a HTTP PATCH request

public function testPatch()
    {
        $rest = new Rest();

        $data = [
            'name' => 'morpheus',
            'job' => 'zion resident'
        ];
        
        @$response = $rest->doPatch($data, [], 'https://reqres.in/api/users/2', 200);
        
        $this->assertStringContainsString('updatedAt', $response);
    }

Testing a HTTP DELETE request

public function testDelete()
    {
        $rest = new Rest();
        
        @$response = $rest->doDelete([],'https://reqres.in/api/users/2',204);

        $this->assertEquals(0,count($rest->requestErrors));
    }
}

You can allow more than one HTTP status code as a valid response. The code snippet below shows a request that allows 200 and 201 status code as valid responses.

        @$response = $rest->doGet([],'http://www.horalegalbrasil.mct.on.br/SincronismoPublico.html',[200,201]);
        
        $this->assertStringContainsString('Sincronismo', $response);