Déboguer vos requêtes HTTP avec le client Laravel

Laravel dispose d'un client HTTP puissant et flexible basé sur Guzzle, permettant d'effectuer des requêtes HTTP simplement. Cependant, lorsqu'une requête ne fonctionne pas comme prévu, il est crucial de disposer d'outils de débogage efficaces. Dans cet article, nous allons explorer les fonctionnalités de débogage du client HTTP de Laravel et comment les utiliser pour inspecter vos requêtes et réponses.

Activer le mode de débogage

Laravel 10.39 introduit une nouvelle fonctionnalité permettant d'enregistrer les détails des requêtes HTTP et de leurs réponses grâce à la méthode withDebugging(). Cette méthode facilite l'inspection des requêtes en loggant les informations nécessaires.

Exemple d'utilisation

Voici comment activer le mode de débogage :

use Illuminate\Support\Facades\Http;

$response = Http::withDebugging()->get('https://api.example.com/data');

Cette simple ligne de code enregistrera les détails de la requête et de la réponse dans les logs de Laravel, accessibles via storage/logs/laravel.log.

Personnalisation du débogage

Il est également possible de personnaliser la façon dont les logs sont enregistrés en passant une fonction de rappel (“closure”) à withDebugging(). Voici un exemple :

$response = Http::withDebugging(function ($request, $response) {
    logger()->info('Requête envoyée : ', $request->toArray());
    logger()->info('Réponse reçue : ', $response->toArray());
})->get('https://api.example.com/data');

Dans cet exemple, Laravel enregistre les détails de la requête et de la réponse dans les logs en utilisant logger()->info().

Utilisation avec Laravel Ray

Si vous utilisez Laravel Ray, un outil puissant pour le débogage, vous pouvez facilement afficher les requêtes et réponses dans une interface conviviale :

use Illuminate\Support\Facades\Http;
use function Spatie\Ray\ray;

$response = Http::withDebugging(function ($request, $response) {
    ray($request->toArray());
    ray($response->toArray());
})->get('https://api.example.com/data');

Cela permet de visualiser les détails de la requête directement dans Ray, ce qui facilite grandement le débogage.

Conclusion

La nouvelle fonctionnalité withDebugging() du client HTTP de Laravel offre une manière simple et efficace d'inspecter les requêtes et réponses HTTP. Que vous utilisiez les logs Laravel ou un outil comme Laravel Ray, cette fonctionnalité vous aidera à identifier rapidement les problèmes de vos appels API.

N'hésitez pas à l'essayer dans vos projets Laravel et à partager vos retours ! 🚀