Comment créer des applications basées sur API à l'aide de PHP et GraphQL

À l'ère numérique d'aujourd'hui, de nombreuses applications s'appuient sur des API (Application Programming Interfaces) pour interagir avec d'autres applications ou services. Les API traditionnelles utilisent l'architecture RESTful, tandis que GraphQL est un langage de requête API émergent qui fournit une solution d'interface API plus efficace, flexible et évolutive. Cet article explique comment utiliser PHP et GraphQL pour créer des applications basées sur des API.

1. Qu'est-ce que GraphQL ?

GraphQL est un langage de requête API et un environnement d'exécution. Il a été développé par Facebook en 2012, initialement pour résoudre leurs problèmes d'appels d'API internes. Contrairement aux API RESTful traditionnelles, GraphQL permet aux applications de décrire exactement les données dont elles ont besoin et de renvoyer uniquement ces données, offrant ainsi des requêtes de données et des temps de réponse plus efficaces.

Les principales fonctionnalités de GraphQL incluent :

1. Utiliser le système de types pour définir l'API, ainsi que l'entrée et la sortie des requêtes et des mutations.

2. Grâce à la capacité de requête flexible, le client peut demander les données requises sans être obligé de renvoyer des données supplémentaires.

3. Prend en charge l'imbrication de petites requêtes dans plusieurs requêtes, réduisant ainsi le nombre de transmissions de données avec le serveur.

4. Offrir la possibilité de développer et de maintenir rapidement des API.

2. Pourquoi utiliser PHP et GraphQL ?

PHP est un langage de développement Web populaire avec un large éventail de domaines d'application et un fort soutien communautaire. Sa combinaison avec GraphQL peut fournir une solution d'interface API plus flexible, efficace et facile à maintenir pour le développement Web.

De plus, GraphQL prend en charge plusieurs langages de programmation, notamment PHP, JavaScript, Java, Python, etc. Dans le même temps, il existe de nombreux projets open source disponibles pour l'implémentation de GraphQL en PHP, tels que WebonyxGraphQL, YoushidoGraphQL, etc. Ces projets fournissent des outils et des solutions puissants aux développeurs pour implémenter des interfaces API à l'aide de GraphQL.

3. Utilisez PHP et GraphQL pour créer une application basée sur une API

Ci-dessous, nous montrerons comment utiliser PHP et GraphQL pour créer une application simple basée sur une API.

1. Installer les dépendances

Utilisez l'outil composer pour gérer les packages de dépendances PHP. Vous pouvez exécuter la commande suivante dans le terminal pour installer rapidement GraphQL :

composer require webonyx/graphql-php

2 Écrire le schéma GraphQL

Le schéma GraphQL est le cœur des points de terminaison de l'API. , qui définit les requêtes, les variantes, les types et autres contenus sont fournis au client. La boîte à outils WebonyxGraphQL peut être utilisée pour créer, analyser et valider des schémas en PHP.

Un exemple de schéma simple :

use GraphQLTypeDefinitionObjectType;
use GraphQLTypeDefinitionType;

$queryType = new ObjectType([
    'name' => 'Query',
    'fields' => [
        'echo' => [
            'type' => Type::string(),
            'args' => [
                'message' => Type::string()
            ],
            'resolve' => function ($root, $args) {
                return $args['message'];
            }
        ]
    ]
]);

Le code ci-dessus crée un type de requête simple, qui a un champ d'écho. Ce champ reçoit un paramètre de message et renvoie le paramètre inchangé.

3. Démarrez le service GraphQL

Pour démarrer le service GraphQL, nous devons transmettre le schéma précédemment créé au service GraphQL. Cela peut être réalisé en appelant la méthode serve fournie par GraphQL :

use GraphQLGraphQL;
use GraphQLTypeSchema;

$schema = new Schema([
    'query' => $queryType
]);

$input = file_get_contents('php://input');
$json = json_decode($input, true);
$query = isset($json['query']) ? $json['query'] : null;
$variableValues = isset($json['variables']) ? $json['variables'] : null;

$result = GraphQL::executeQuery($schema, $query, null, null, $variableValues);
$output = $result->toArray();
header('Content-Type: application/json; charset=UTF-8');
echo json_encode($output);

4. API

Lorsque le service GraphQL est lancé, il est accessible en utilisant n'importe quel client HTTP. L'exemple suivant montre comment utiliser curl pour demander une API GraphQL :

curl -X POST -H 'Content-Type: application/json' 
    --data '{ "query": "{ echo(message: "Hello, GraphQL!") }" }' 
    http://localhost:8080/graphql

La commande ci-dessus renverra la réponse JSON suivante :

{
  "data": {
    "echo": "Hello, GraphQL!"
  }
}

Dans l'exemple ci-dessus, nous avons montré comment créer une application pilotée par API à l'aide de PHP et GraphQL. L'efficacité, la flexibilité et l'évolutivité de GraphQL en font un excellent choix pour créer des API modernes, tandis que les puissantes performances de PHP et la large gamme d'applications en font un langage de développement idéal.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!