[toc]
#### 預備知識
本文檔假定您熟悉GraphQL概念,如果沒有,可以先學[官網](http://graphql.org/learn/)的GraphQL介紹。
#### 安裝
Using [composer](https://getcomposer.org/doc/00-intro.md),`composer.json`
~~~
{
"require": {
"webonyx/graphql-php": "^0.8"
}
}
~~~
#### 更新
[upgrade instructions](https://github.com/webonyx/graphql-php/blob/master/UPGRADE.md)
#### 安裝工具(可選)
雖然可以使用常規的`HTTP`與`GraphQL API`通訊,但是使用[`GraphiQL`](https://github.com/graphql/graphiql),用瀏覽器內的工具探索`GraphQL APIs`
更方便的方式是安裝chrome 擴展。
* [ GraphiQL Feen](https://chrome.google.com/webstore/detail/graphiql-feen/mcbfdonlkfpbfdpimkjilhdneikhfklp)
* [ChromeiQL](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij)
#### Hello World
讓我們創建類型系統來處理下面的簡單查詢。
~~~
query {
echo(message: "Hello World")
}
~~~
為此我們需要定義帶有字段`echo`的對象類型。
~~~
use GraphQL\Type\Definition\ObjectType;
use GraphQL\Type\Definition\Type;
$queryType = new ObjectType([
'name' => 'Query',
'fields' => [
'echo' => [
'type' => Type::string(),
'args' => [
'message' => Type::nonNull(Type::string()),
],
'resolve' => function ($root, $args) {
return $root['prefix'] . $args['message'];
}
],
],
]);
~~~
(Note:類型定義能夠使用不同的方式,這里為了簡單使用內聯方式定義)
有意思的部分是這里字段定義的`resolve`選項,它負責返回字段的值,`scalar`類型字段的值會直接包含到響應中,然而如果是`complex`類型(`objects`, `interfaces`, `unions`)的值會被傳給它下面嵌套的字段解析器。
現在類型已經準備好,讓我們創建GraphQL服務端點。
~~~
use GraphQL\GraphQL;
use GraphQL\Schema;
$schema = new Schema([
'query' => $queryType
]);
$rawInput = file_get_contents('php://input');
try {
$rootValue = ['prefix' => 'You said: '];
$result = GraphQL::execute($schema, $rawInput, $rootValue);
} catch (\Exception $e) {
$result = [
'error' => [
'message' => $e->getMessage()
]
];
}
header('Content-Type: application/json; charset=UTF-8');
echo json_encode($result);
~~~
運行代碼
~~~
php -S localhost:8000 graphql.php
curl http://localhost:8000 -d "query { echo(message: \"Hello World\") }"
~~~
hello world示例只是很簡單的例子,可以查看下一例子,它更接近現實生活的應用程序。
#### Blog Example
通過更容易從全功能的例子開始,然后返回文檔開始你自己的工作。