https://github.com/tal7aouy/yusr

🚀 Yusr: A lightweight, powerful PHP HTTP client inspired by Guzzle
https://github.com/tal7aouy/yusr

guzzle guzzlehttp http http-client php-http-client php-https

Last synced: 3 months ago
JSON representation

🚀 Yusr: A lightweight, powerful PHP HTTP client inspired by Guzzle

• Host: GitHub
• URL: https://github.com/tal7aouy/yusr
• Owner: tal7aouy
• License: mit
• Created: 2024-10-06T20:13:48.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-10-27T19:26:58.000Z (3 months ago)
• Last Synced: 2024-10-27T22:58:57.219Z (3 months ago)
• Topics: guzzle, guzzlehttp, http, http-client, php-http-client, php-https
• Language: PHP
• Homepage:
• Size: 104 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# 🚀 YusrClient - A Powerful PHP HTTP Client



  



[![Latest Version on Packagist](https://img.shields.io/packagist/v/tal7aouy/yusr.svg?style=flat-square)](https://packagist.org/packages/tal7aouy/yusr)

[![Total Downloads](https://img.shields.io/packagist/dt/tal7aouy/yusr.svg?style=flat-square)](https://packagist.org/packages/tal7aouy/yusr)

[![License](https://img.shields.io/packagist/l/tal7aouy/yusr.svg?style=flat-square)](https://packagist.org/packages/tal7aouy/yusr)

YusrClient is a robust and easy-to-use PHP HTTP client that simplifies making HTTP requests in your PHP applications. Built with modern PHP practices, it implements the PSR-18 HTTP Client interface and provides a fluent API for sending HTTP requests.

## ✨ Key Features

- 🔒 PSR-18 HTTP Client compliant

- 🛠 Singleton pattern implementation

- 🚦 Full HTTP method support (GET, POST, PUT, DELETE, PATCH)

- 🔄 Automatic retry mechanism with exponential backoff

- 🔧 Highly customizable request options

- 🧩 Intuitive fluent interface

- ⏱ Configurable timeouts

- 🔐 SSL verification support

## 📦 Installation

```bash

composer require tal7aouy/yusr

```

## 🚀 Quick Start

```php

use Yusr\Http\YusrClient;

// Get client instance

$client = YusrClient::getInstance();

// Make a GET request

$response = $client->get('https://api.example.com/users');

// Work with response

$statusCode = $response->getStatusCode();

$data = $response->getBody()->getContents();

$headers = $response->getHeaders();

```

## ⚙️ Configuration

```php

$client = YusrClient::getInstance([

    'timeout' => 30,

    'allow_redirects' => true,

    'verify' => true,

    'retry' => [

        'max_attempts' => 3,

        'delay' => 1000 // milliseconds

    ]

]);

```

## 📘 Available Methods

### HTTP Methods

```php

$client->get(string $uri, array $options = []);

$client->post(string $uri, array $options = []);

$client->put(string $uri, array $options = []);

$client->delete(string $uri, array $options = []);

$client->patch(string $uri, array $options = []);

```

### Request Options

- `query` - Array of URL query parameters

- `headers` - Custom request headers

- `body` - Request body (for POST, PUT, PATCH)

- `timeout` - Request timeout in seconds

- `allow_redirects` - Follow redirects (boolean)

- `verify` - SSL certificate verification

- `retry` - Retry configuration for failed requests

## 🔄 Retry Mechanism

YusrClient includes a sophisticated retry mechanism with exponential backoff:

```php

$client = YusrClient::getInstance([

    'retry' => [

        'max_attempts' => 3,

        'delay' => 1000,

        'multiplier' => 2

    ]

]);

```

## 🤝 Contributing

Contributions are always welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.

## 📝 License

This project is licensed under the [MIT License](LICENSE).

## 🙏 Support

If you find this package helpful, please consider giving it a star ⭐️