PHP Academy · Leçon

Créer un client d’API simple

Encapsuler les appels cURL dans une classe cliente d’API PHP réutilisable.

Créer un client d’API simple est une leçon PHP Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage PHP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours PHP Academy comprend 4 leçons au total.

Pourquoi encapsuler cURL ?

Une classe cliente d’interface de programmation dédiée centralise l’authentification, l’URL de base, la gestion des erreurs et la journalisation, ce qui évite de répéter du code standard dans toute la base de code.

Squelette de classe cliente

Un client d’interface de programmation minimal avec une URL de base et un jeton d’authentification.

<?php
class ApiClient {
    public function __construct(
        private string $baseUrl,
        private string $token
    ) {}

    private function request(string $method, string $path, array $data = []): array {
        $ch = curl_init($this->baseUrl.$path);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST  => $method,
            CURLOPT_HTTPHEADER     => [
                "Authorization: Bearer ".$this->token,
                "Content-Type: application/json",
                "Accept: application/json",
            ],
        ]);
        if (!empty($data)) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
        $body   = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($status >= 400) throw new RuntimeException("API error $status: $body");
        return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
    }
}

Méthodes GET et POST

Exposez des méthodes pratiques qui délèguent l’exécution à la méthode privée request().

<?php
public function get(string $path): array {
    return $this->request("GET", $path);
}

public function post(string $path, array $body): array {
    return $this->request("POST", $path, $body);
}

Utilisation du client

Instanciez le client et appelez des méthodes typées plutôt que d’utiliser cURL directement.

<?php
$client = new ApiClient("https://api.example.com", $apiToken);
$users  = $client->get("/v1/users");
$user   = $client->post("/v1/users", ["name" => "Alice", "email" => "alice@example.com"]);

Paramètres de chaîne de requête

Construisez les chaînes de requête avec http_build_query().

<?php
public function get(string $path, array $params = []): array {
    $qs = $params ? "?".http_build_query($params) : "";
    return $this->request("GET", $path.$qs);
}
// Usage:
$users = $client->get("/v1/users", ["page" => 1, "limit" => 20]);

Fonction utilitaire de pagination

Ajoutez une fonction utilitaire qui collecte automatiquement toutes les pages d’une interface de programmation paginée.

<?php
public function paginate(string $path): array {
    $all  = [];
    $page = 1;
    do {
        $res  = $this->get($path, ["page" => $page++]);
        $all  = array_merge($all, $res["data"]);
    } while ($res["has_more"] ?? false);
    return $all;
}

Mise en cache des réponses

Injectez une couche de cache afin d’éviter les requêtes redondantes.

<?php
public function getCached(string $path, int $ttl = 60): array {
    $key = "api:".md5($path);
    if (apcu_exists($key)) return apcu_fetch($key);
    $data = $this->get($path);
    apcu_store($key, $data, $ttl);
    return $data;
}

Journalisation

Ajoutez un outil de journalisation PSR-3 pour enregistrer chaque requête et chaque réponse à des fins de débogage.

<?php
public function __construct(
    private string $baseUrl,
    private string $token,
    private ?\Psr\Log\LoggerInterface $logger = null
) {}

Test du client

Dans les tests unitaires, remplacez cURL par un gestionnaire HTTP simulé (par exemple, Guzzle MockHandler) afin que les tests s’exécutent sans appels réseau réels.

Guzzle comme solution alternative

Pour une utilisation en production, envisagez Guzzle (composer require guzzlehttp/guzzle), qui fournit des intergiciels, des requêtes asynchrones et une interface aboutie.

Option HTTP_FOUNDATION

Symfony HttpClient (symfony/http-client) est une autre excellente solution, dotée d’une interface claire et d’une prise en charge asynchrone de premier ordre.

Résumé

Encapsuler cURL dans une classe réduit la duplication, centralise la gestion des erreurs et facilite les tests. Exposez des méthodes typées (get, post) plutôt que les verbes HTTP bruts.

Vérification rapide

Quelle fonction PHP construit les chaînes de requête d’une URL ?

Questions Fréquemment Posées

La leçon « Créer un client d’API simple » est-elle gratuite ?

Oui — le texte complet de « Créer un client d’API simple » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours PHP Academy, passe à CoddyKit PRO. Le cours PHP Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Créer un client d’API simple » ?

Encapsuler les appels cURL dans une classe cliente d’API PHP réutilisable. Tu pratiques PHP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer PHP Academy ?

Aucune expérience préalable n'est requise. PHP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Créer un client d’API simple » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon PHP Academy ?

Oui. Chaque leçon PHP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à PHP Academy