hyperf/docs/zh-tw/graphql.md

# GraphQL

GraphQL 元件對 [thecodingmachine/graphqlite](https://github.com/thecodingmachine/graphqlite) 進行抽象。

## 安裝

```bash
composer require hyperf/graphql
```

## 快速開始

### 簡單查詢
```php
<?php

namespace App\Controller;

use GraphQL\GraphQL;
use GraphQL\Type\Schema;
use Hyperf\Di\Annotation\Inject;
use Hyperf\GraphQL\Annotation\Query;
use Hyperf\HttpServer\Annotation\Controller;
use Hyperf\HttpServer\Annotation\PostMapping;
use Hyperf\HttpServer\Contract\RequestInterface;

/**
 * @Controller()
 */
class GraphQLController
{
    /**
     * @Inject()
     * @var Schema
     */
    protected $schema;
    
    /**
     * @PostMapping(path="/graphql")
     */
    public function test(RequestInterface $request)
    {
        $rawInput = $request->getBody()->getContents();
        $input = json_decode($rawInput, true);
        $query = $input['query'];
        $variableValues = isset($input['variables']) ? $input['variables'] : null;
        return GraphQL::executeQuery($this->schema, $query, null, null, $variableValues)->toArray();
    }
    
    /**
     * @Query()
     */
    public function hello(string $name): string
    {
        return $name;
    }
}
```
查詢:
```graphql
{
    hello(name: "graphql")
}
```
響應:
```json
{
    "data": {
        "hello": "graphql"
    }
}
```

### 型別對映

```php
<?php
namespace App\Model;

use Hyperf\GraphQL\Annotation\Type;
use Hyperf\GraphQL\Annotation\Field;

/**
 * @Type()
 */
class Product
{
    protected $name;
    protected $price;

    public function __construct(string $name, float $price)
    {
        $this->name = $name;
        $this->price = $price;
    }

    /**
     * @Field()
     */
    public function getName(): string
    {
        return $this->name;
    }

    /**
     * @Field()
     */
    public function getPrice(): ?float
    {
        return $this->price;
    }
}
```

在 `GraphQLController` 中加入

```php
<?php
use App\Model\Product;

/**
 * @Query()
 */
public function product(string $name, float $price): Product
{
    return new Product($name, $price);
}
```

查詢:
```graphql
{
    hello(name: "graphql")
    product(name: "goods", price: 156.5) {
        name
        price
    }
}
```

響應:
```json
{
    "data": {
        "hello": "graphql",
        "product": {
            "name": "goods",
            "price": 156.5
        }
    }
}
```

更多使用方法可以檢視 [GraphQLite](https://graphqlite.thecodingmachine.io/docs/queries) 的文件。