GraphQL-js教程-PHP中文网

GraphQL

PHPz

发布： 2024-08-10 16:38:03

原创

687 人浏览过

GraphQL

什么是 GraphQL？

GraphQL 是一种强大的 API 查询语言，也是使用数据执行这些查询的运行时。 GraphQL 由 Facebook 于 2012 年开发，并于 2015 年作为开源项目发布，它允许客户准确请求他们需要的数据——不多也不少。

主要特点：

单个端点：与通常使用多个端点的 REST 不同，GraphQL 对所有请求使用单个端点。
灵活的查询：客户端可以在单个查询中仅请求他们需要的特定数据。
强类型：模式定义 API 中的类型和关系，确保强大的数据验证和内省。

GraphQL 与 REST 有何不同

1。数据获取：

REST：需要多个端点来获取相关数据。例如，您可能需要点击 /users，然后点击 /users/{id}/posts。
GraphQL：允许在单个查询中获取所有必需的数据。您可以通过一次请求获取用户详细信息及其帖子。

2。过度获取和不足获取：

REST：经常返回超出需要的数据（过度获取）或需要额外的请求来获取更多数据（获取不足）。
GraphQL：客户端准确指定他们需要的数据，消除过度获取和获取不足的情况。

3。版本控制：

REST：API 版本可能需要更新（例如，/v1/users 到 /v2/users）。
GraphQL：无需版本控制即可发展。可以添加新字段和类型，而不会破坏现有查询。

基本 GraphQL 查询示例

以下是编写 GraphQL 查询来获取用户信息的方法：

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

登录后复制

在此查询中：

user(id: "1") 指定获取 ID 为 1 的用户。
请求嵌套字段名称、电子邮件和帖子。
帖子包含子字段标题和内容，允许嵌套数据结构。

设置简单的 GraphQL 服务器

要开始使用 GraphQL，让我们使用 Node.js 和 Apollo Server 设置一个基本服务器。

1。安装依赖项：

npm install apollo-server graphql

登录后复制

2。创建基本服务器：

创建一个名为index.js的文件并添加以下代码：

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。运行服务器：