FetchPHP, une très jeune lib inspirée de l’API fetch JS

Pourquoi choisir FetchPHP plutôt que Guzzle ?

1. Véritable gestion asynchrone avec les Fibers : Contrairement à Guzzle qui utilise les Promises pour la gestion asynchrone, FetchPHP s’appuie sur les Fibers, introduits dans PHP 8.1, pour une vraie gestion non bloquante des tâches. Cela permet une gestion fine du cycle de vie des tâches (pause, reprise, annulation, etc.).
2. Syntaxe async/await : FetchPHP introduit une syntaxe async/await similaire à celle de JavaScript, rendant le code PHP asynchrone plus lisible et intuitif.
3. API fluide et enchaînable : L’API fluide de FetchPHP rend la création et la gestion des requêtes HTTP plus flexible et lisible que l’approche basée sur les Promises de Guzzle.
4. Gestion avancée des erreurs : FetchPHP permet une gestion des erreurs personnalisable avec la possibilité de définir des gestionnaires d’erreurs spécifiques et des mécanismes de reprise.

Différences dans la gestion des tâches asynchrones

• Concurrence basée sur les Fibers : FetchPHP utilise les Fibers pour exécuter les tâches de manière asynchrone, permettant une meilleure gestion des tâches longues ou concurrentes par rapport aux Promises de Guzzle.
• Contrôle du cycle de vie des tâches : FetchPHP permet de démarrer, mettre en pause, reprendre ou annuler des tâches, ainsi que de suivre leur statut. Ce niveau de contrôle n’est pas offert par Guzzle.
• Gestion personnalisée des erreurs : Avec FetchPHP, il est possible de personnaliser la gestion des erreurs et de définir des stratégies de reprise des tâches en cas d’échec.

Exemples d’utilisation de FetchPHP

Requête asynchrone avec gestion du cycle de vie

use Fetch\\Interfaces\\Response as ResponseInterface;

// Envoi asynchrone d'une requête POST
async(fn () => fetch('<https://example.com>', [
    'method' => 'POST',
    'headers' => ['Content-Type' => 'application/json'],
    'body' => json_encode(['key' => 'value']),
]))
    ->then(fn (ResponseInterface $response) => $data = $response->json())  // Gestion de la réussite
    ->catch(fn (\\Throwable $e) => echo "Erreur : " . $e->getMessage());     // Gestion des erreurs

Contrôle manuel d’une tâche asynchrone

use Matrix\\Task;
use Matrix\\Enum\\TaskStatus;

$task = new Task(function () {
    return "Tâche terminée !";
});

$task->start();  // Démarrage de la tâche
$task->pause();  // Pause de la tâche
$task->resume(); // Reprise de la tâche
$task->cancel(); // Annulation de la tâche

// Réessayer en cas d’échec
if ($task->getStatus() === TaskStatus::FAILED) {
    $task->retry();
}

$result = $task->getResult();

Installation

composer require jerome/fetch-php

Conclusion