README

Introduction

Gonon Core is the foundation package for the entire Gonon ecosystem. It provides reusable, vendor-agnostic, and framework-agnostic infrastructure shared by every Gonon SDK.

Features

HTTP Abstraction via PSR interfaces
Configuration management
Unified Exception hierarchy
Retry mechanisms (Exponential Backoff, Fixed Delay)
Collections and DTO foundations
Authentication contracts
Testing utilities

Requirements

PHP 8.2 or higher

Installation

You can install the package via composer:

composer require gonon/core

Configuration

Gonon Core uses immutable configuration objects.

use Gonon\Core\Configuration\Config;
use Gonon\Core\Configuration\Environment;

$config = new Config(
    environment: Environment::Production,
    timeout: 30,
);

Quick Start

Core is primarily used by SDKs to build robust HTTP integrations.

// 1. Choose your transport adapter (e.g. from gonon/http-symfony)
$adapter = new \Gonon\Http\Symfony\SymfonyHttpClient();

// 2. (Optional) Configure a retry strategy
$retry = new \Gonon\Core\Retry\ExponentialBackoffStrategy(maxAttempts: 3, baseDelayMs: 500);

// 3. Initialize the Orchestrator
$client = new \Gonon\Core\Http\Client(
    adapter: $adapter,
    retryStrategy: $retry,
    defaultHeaders: ['User-Agent' => 'Gonon-SDK/1.0']
);

// 4. Send Request (Middlewares, Retries, and Logging run automatically!)
$response = $client->sendRequest($request);

Examples

Check the examples/ directory for full usage examples.

API Reference

The full API reference is available within the source code via PHPDoc annotations.

Testing

composer test

Contributing

Please see CONTRIBUTING.md for details.

License

The MIT License (MIT). Please see LICENSE for more information.

gonon / core

Maintainers

Package info

Statistics

Security