README

chaoswd/http is a lightweight HTTP client wrapper for PHP that simplifies making GET and POST requests using native cURL.
It provides simple methods for sending requests and returning structured responses as a string, objects or arrays.

🚀 Installation

Install via Composer:

composer require chaoswd/http

🧩 Basic Usage

<?php

require __DIR__ . '/../vendor/autoload.php';

use Chaos\Http\Http;

$http = new Http();

// Basic GET request
$response = $http->get('https://jsonplaceholder.typicode.com/todos/1');

// $response is now a response object - use `json()`, `object()`, or `array()` for which response type you want.
var_dump($response->json());

⚙️ Features

Simplified wrapper around PHP’s native cURL
Supports GET, POST methods
Handles headers and query parameters
Configurable timeout

Example POST request:

$response = $http->post('https://example.com/api/posts', [
    'title' => 'Chaos Framework',
    'body'  => 'Lightweight HTTP client test',
]);

📚 Methods

Method	Description
`get(string $url, array $params = [])`	Send a GET request
`post(string $url, array $data = [])`	Send a POST request
`withHeaders(array $headers)`	Set request headers
`withTimeout(int $seconds)`	Set request timeout
`headers()`	Return headers
`json()`	Return a JSON string
`object()`	Parse JSON as objects
`array()`	Parse JSON as arrays

🧾 Example: Custom Headers

$http = new Chaos\Http\Http();

$http->withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN_HERE',
    'Accept' => 'application/json'
]);

$response = $http->get('https://api.example.com/user')->json();

🧰 Requirements

PHP 8.2+
cURL extension enabled

🪪 License

Released under the MIT License.

chaoswd / http

Maintainers

Details