README

A simple and lightweight library for crafting HTTP requests.

Installation

composer require snapflow/requests

Quick Start

<?php

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

use Snapflow\Requests\Client;
use Snapflow\Requests\HttpMethod;
use Snapflow\Requests\ContentType;

// Simple GET request
$client = new Client();
$response = $client->fetch('https://api.example.com/users/1');
echo $response->text();

// GET with JSON parsing
$data = $response->json();
echo $data['name'];

// POST with JSON body
$client = new Client();
$client->addHeader('Content-Type', ContentType::APPLICATION_JSON->value);

$response = $client->fetch(
    url: 'https://api.example.com/users',
    method: HttpMethod::POST->value,
    body: [
        'name' => 'John Doe',
        'email' => 'john@example.com'
    ]
);

// GET with query parameters
$response = $client->fetch(
    url: 'https://api.example.com/users',
    query: ['page' => 1, 'limit' => 10]
);

// Configure retries and timeouts
$client->setMaxRetries(3)
       ->setRetryDelay(1000)
       ->setTimeout(30000);

License

This library is available under the MIT License.

Copyright

Copyright (c) 2025 Snapflow