simsoft/http-client

A simple CURL HTTP Client.

1.0.0 2025-06-23 00:50 UTC

Requires

• php: ^8
• ext-curl: *
• league/oauth2-client: ^2.8

Requires (Dev)

• phpmd/phpmd: ^2.13
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9
• squizlabs/php_codesniffer: ^3.7

MIT

• V. Zang, Loo

• curl
• http client
• api client

README

A simple CURL HTTP client implementation.

Install

composer require simsoft/http-client

Basic Setup

require "vendor/autoload.php";

use Simsoft\HttpClient\HttpClient;

$response = (new HttpClient())
     ->withBaseUri('https://domain.com/api')
     ->withMethod('GET')
     ->query(['foo' => 'bar'])
     ->withHeaders(['Authorization' => 'Bearer secret_token'])
     ->request();

if ($response->ok()) {
    //{"status": 200, "data": [{"name": "John Doe","gender": "m"},{"name": "Jane Doe","gender": "f"}]}
    echo $response->getAttribute('status') . PHP_EOL;
    echo $response->getAttribute('data.0.name') . PHP_EOL;
    echo $response->getAttribute('data.1.name') . PHP_EOL;
} else {
    // {"errors": {"status": 404, "title": "The resource was not found"}}
    echo $response->getAttribute('errors.status') . PHP_EOL;
    echo $response->getAttribute('errors.title') . PHP_EOL;
}

// Output:
200
John Doe
Jane Doe

Custom Http Client

namespace App;

use Simsoft\HttpClient\HttpClient;

class MyCustomClient extends HttpClient
{
    protected string $endpoint = 'https://api.domain.com';

    /**
    * Constructor
    *
    * @param string $clientId
    * @param string $secret
    */
    public function __construct(protected string $clientId, protected string $secret)
    {

    }

    /**
    * @param int $id
    * @return mixed
    */
    public function getUserProfile(int $id)
    {
        return $this
            ->withBaseUri($this->endpoint)
            ->withHeaders([
                'clientId' => $this->clientId,
                'secret' => $this->secret,
            ])
            ->get(['userId' => $id]);
    }
}


$client = new MyCustomClient(CLIENT_ID, CLIENT_SECRET);
$response = $client->getUserProfile(99);

echo $response->getAttribute('name');

// Output:
John Doe.

License

The Simsoft HttpClient is licensed under the MIT License. See the LICENSE file for details