Exemples complets et tutoriels pratiques pour appeler les interfaces API à l'aide de Curl

Aperçu

Dans le développement de PHP, l'interaction des données avec des services tiers ou d'autres systèmes est souvent nécessaire, et l'interface API est l'une des méthodes les plus couramment utilisées. À l'aide de l'extension Curl intégrée de PHP, nous pouvons facilement implémenter les demandes HTTP et une communication complète avec l'API. Cet article utilisera un exemple complet pour montrer comment faire fonctionner les interfaces API à l'aide de Curl de PHP.

Préparation

Installer une extension Curl

Avant de commencer, assurez-vous que l'extension Curl est installée dans l'environnement PHP. Vous pouvez le vérifier via la ligne de commande:

 php -i | grep -i curl

Si la sortie contient des informations liées à Curl, cela signifie que la boucle est installée. Sinon, vous pouvez l'installer via la commande suivante (prendre Debian / Ubuntu comme exemple):

 sudo apt-get install php-curl

Créer une classe pour l'interface de l'API de fonctionnement Curl

Pour la structure du code claire et facile à entretenir, nous encapsulons une classe pour gérer les demandes de boucles de manière centralisée.

classe curlapiclient {
    Private $ fondatl;
    
    Fonction publique __construct ($ BUSURL) {
        $ this-> substanTl = $ bunding;
    }
    
    Demande de fonction publique ($ endpoint, $ params = array (), $ méthode = 'get') {
        $ url = $ this-> substanl. '/'. $ Endpoint;
        $ ch = curl_init ();
        if ($ méthode == 'post') {
            curl_setopt ($ ch, curlopt_post, 1);
            curl_setopt ($ ch, curlopt_postfields, http_build_query ($ params));
        } autre {
            $ url. = '?' . http_build_query ($ params);
        }
        curl_setopt ($ ch, curlopt_url, $ url);
        curl_setopt ($ ch, curlopt_returntransfer, 1);
        $ réponse = curl_exec ($ ch);
        if (curl_errno ($ ch)) {
            $ error = curl_error ($ ch);
            curl_close ($ ch);
            Jetez une nouvelle exception ("Erreur de demande de curl:". $ ERROR);
        }
        curl_close ($ ch);
        retour $ réponse;
    }
}

Appel d'interface API à l'aide de la classe Curl

Voici un exemple de la façon d'utiliser la classe encapsulée ci-dessus pour les demandes d'API:

$ BUSURL = 'https://api.example.com';
$ apikey = 'your-ap-key';
$ client = new curlapiclient ($ bunding);
essayer {
    $ endpoint = 'utilisateurs';
    $ params = array ('apikey' => $ apikey);
    $ réponse = $ client-> request ($ endpoint, $ params, 'get');
    Echo $ réponse;
} catch (exception $ e) {
    Echo 'Demande a échoué:'. $ e-> getMessage ();
}

Le code ci-dessus démontre la mise en œuvre de la demande GET. La demande de post doit uniquement modifier le dernier paramètre en "publier" et passer le tableau de paramètres correspondant.

Résumer

Cet article présente la méthode d'installation des extensions de boucle dans l'environnement PHP, résume une classe d'appel API commune et montre comment initier des demandes et publier des demandes. En utilisant cette méthode d'encapsulation, les appels d'API peuvent être rendus plus modulaires et faciles à maintenir, adaptés à l'intégration des fonctions d'API dans divers projets PHP.