PHP搭建GraphQLAPI教程详解

哈喽！今天心血来潮给大家带来了《PHP实现GraphQL API教程》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

使用webonyx/graphql-php可快速搭建PHP的GraphQL API：先通过Composer安装库，定义User对象类型及包含user查询的Schema，编写resolve函数模拟数据返回，创建schema实例并在入口文件处理请求，最终返回JSON响应，支持前端调用。

PHP 中实现 GraphQL API 主要是通过 Webonyx/GraphQL-PHP 这个库，它是 PHP 社区中最成熟、最广泛使用的 GraphQL 实现。下面带你一步步搭建一个简单的 GraphQL API 服务。

1. 安装 Webonyx GraphQL-PHP

composer require webonyx/graphql-php

2. 定义 Schema 和类型

例如，我们构建一个简单的“用户”查询 API：

use GraphQL\Type\Definition\Type;
use GraphQL\Type\Definition\ObjectType;

$userType = new ObjectType([
    'name' => 'User',
    'fields' => [
        'id'   => Type::nonNull(Type::int()),
        'name' => Type::string(),
        'email' => Type::string(),
    ]
]);

$queryType = new ObjectType([
    'name' => 'Query',
    'fields' => [
        'user' => [
            'type' => $userType,
            'args' => [
                'id' => Type::int()
            ],
            'resolve' => function ($root, $args) {
                // 模拟数据
                $users = [
                    1 => ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'],
                    2 => ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com'],
                ];
                return $users[$args['id']] ?? null;
            }
        ]
    ]
]);

3. 创建 Schema 实例

use GraphQL\Type\Schema;

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

4. 处理 GraphQL 请求

use GraphQL\GraphQL;

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

try {
    $result = GraphQL::executeQuery($schema, $query, null, null, $variableValues);
    $output = $result->toArray();
} catch (\Exception $e) {
    $output = [
        'error' => [
            'message' => $e->getMessage()
        ]
    ];
}

header('Content-Type: application/json');
echo json_encode($output);

5. 测试你的 GraphQL API

请求体示例：

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

{
  "data": {
    "user": {
      "id": 1,
      "name": "Alice",
      "email": "alice@example.com"
    }
  }
}

6. 可选：集成到框架（如 Laravel 或 Symfony）

安装方法：
composer require rebing/graphql-laravel
然后按文档发布配置并注册 schema。

总结

• 使用 webonyx/graphql-php 定义类型和 schema
• 编写 resolve 函数获取真实数据（可连接数据库）
• 通过入口脚本解析请求并返回 JSON 响应
• 前端可用 Apollo、Relay 或简单 fetch 调用

终于介绍完啦！小伙伴们，这篇关于《PHP搭建GraphQLAPI教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！