GraphQL

Qu'est-ce que GraphQL ?

GraphQL est un langage de requête puissant pour votre API et un environnement d'exécution pour exécuter ces requêtes avec vos données. Développé par Facebook en 2012 et publié en tant que projet open source en 2015, GraphQL permet aux clients de demander exactement les données dont ils ont besoin, ni plus, ni moins.

Caractéristiques principales :

• Point de terminaison unique : contrairement à REST, qui utilise généralement plusieurs points de terminaison, GraphQL utilise un seul point de terminaison pour toutes les requêtes.
• Requêtes flexibles : les clients peuvent demander uniquement les données spécifiques dont ils ont besoin dans une seule requête.
• Strong Typing : le schéma définit les types et les relations dans l'API, garantissant une validation et une introspection robustes des données.

En quoi GraphQL diffère de REST

1. Récupération de données :

• REST : nécessite plusieurs points de terminaison pour récupérer les données associées. Par exemple, vous devrez peut-être cliquer sur /users, puis sur /users/{id}/posts.
• GraphQL : permet de récupérer toutes les données requises en une seule requête. Vous pouvez obtenir les détails des utilisateurs et leurs publications en une seule demande.

2. Sur-récupération et sous-récupération :

• REST : renvoie souvent plus de données que nécessaire (sur-récupération) ou nécessite des requêtes supplémentaires pour obtenir plus de données (sous-récupération).
• GraphQL : les clients spécifient exactement les données dont ils ont besoin, éliminant ainsi la sur-récupération et la sous-récupération.

3. Gestion des versions :

• REST : les versions de l'API devront peut-être être mises à jour (par exemple, de /v1/users à /v2/users).
• GraphQL : Évolue sans versioning. De nouveaux champs et types peuvent être ajoutés sans interrompre les requêtes existantes.

Exemple de requête GraphQL de base

Voici comment écrire une requête GraphQL pour récupérer les informations utilisateur :

query {
  user(id: "1") {
    name
    email
    posts {
      title
      content
    }
  }
}

Dans cette requête :

• user(id: "1") spécifie la récupération d'un utilisateur avec l'ID 1.
• Les champs imbriqués nom, email et publications sont demandés.
• les publications incluent le titre et le contenu des sous-champs, permettant une structure de données imbriquée.

Configuration d'un serveur GraphQL simple

Pour démarrer avec GraphQL, configurons un serveur de base à l'aide de Node.js et Apollo Server.

1. Installer les dépendances :

npm install apollo-server graphql

2. Créer un serveur de base :

Créez un fichier nommé index.js et ajoutez le code suivant :

const { ApolloServer, gql } = require('apollo-server');

// Define your type definitions
const typeDefs = gql`
  type Post {
    title: String
    content: String
  }

  type User {
    name: String
    email: String
    posts: [Post]
  }

  type Query {
    user(id: String!): User
  }
`;

// Define your resolvers
const resolvers = {
  Query: {
    user: (_, { id }) => ({
      name: "John Doe",
      email: "john.doe@example.com",
      posts: [
        { title: "GraphQL Basics", content: "Learning GraphQL is fun!" }
      ]
    }),
  },
};

// Create an Apollo Server instance
const server = new ApolloServer({ typeDefs, resolvers });

// Start the server
server.listen().then(({ url }) => {
  console.log(`? Server ready at ${url}`);
});

3. Exécutez le serveur :

node index.js

Votre serveur sera maintenant en cours d'exécution et vous pourrez le tester à l'aide de GraphiQL (disponible sur http://localhost:4000) ou de n'importe quel client GraphQL.

Pourquoi utiliser GraphQL ?

• Chargement efficace des données : demandez exactement ce dont vous avez besoin, réduisant ainsi les transferts de données inutiles.
• Sécurité des schémas et des types : appliquez la structure des données et validez les données efficacement.
• Expérience développeur : des outils tels que GraphiQL et Apollo Client améliorent la productivité grâce à des fonctionnalités telles que la saisie semi-automatique et la documentation.

Démarrez avec GraphQL aujourd'hui !

En utilisant GraphQL, vous pouvez créer des API plus efficaces, flexibles et évolutives. Restez à l'écoute pour la semaine prochaine, où nous approfondirons les sujets avancés de GraphQL tels que la conception de schémas et les mutations.

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!