mykehowells/httpeep

PHP HTTP client for API endpoint/resource requests

HttPeep

PHP HTTP client for API endpoint/resource requests, _(*1)

Setup

Composer

If you use composer, enter the following command into terminal:, _(*2)

composer require mykehowells/httpeep, _(*3)

Then add require 'vendor/autoloader.php' to your PHP project., _(*4)

Non-Composer

To start using HttPeep, clone this repo into your project; Using SPL autoloader, enter the following code into your project to load the required files., _(*5)

set_include_path( CLASSES_DIR );
spl_autoload_extensions('.class.php');
spl_autoload_register();

This will include the files as they are called within your project and within he HttPeep files., _(*6)

Usage

A simple use case of HttPeep, is below;, _(*7)

$client = new \HttPeep\Client( 'https://api.example.com' );

$response = $client->post( "/user/auth", [
     'token' => $_SESSION['api']['token'],
     'username' => $_POST['username'],
     'password' => md5( $_POST['password'] )
] );

var_export( $response );

You can also use the \HttPeep\Client->json() method to return JSON taken from the body., _(*8)

$client = new \HttPeep\Client( 'https://api.example.com' );

$response = $client->post( "/user/auth", [
     'token' => $_SESSION['api']['token'],
     'username' => $_POST['username'],
     'password' => md5( $_POST['password'] )
] )->json();

var_export( $response );

Methods

Methods available from HttPeep are:, _(*9)

• GET
• POST
• DELETE
• PUT

Client Config

When instantiating \HttPeep\Client(), you can pass an array of config variables for cURL; for example:, _(*10)

$client = new \HttPeep\Client( 'https://api.example.com', [
    'curl' => [
        'followlocation' => true, // CURLOPT_FOLLOWLOCATION - follow any Location: header sent as part of the HTTP header
        'maxredirs' => 10 // CURLOPT_MAXREDIRS - Maximum number of HTTP redirections to follow
    ]
] );

Default CURLOPTS that are set within the Client are:, _(*11)