# think-graphql

**Repository Path**: smilec/think-graphql

## Basic Information

- **Project Name**: think-graphql
- **Description**: 为ThinkPHP5打造更好用的GraphQL SDK，拥有完整的中文文档支持。
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://smilecc.github.io/think-graphql/
- **GVP Project**: No

## Statistics

- **Stars**: 37
- **Forks**: 12
- **Created**: 2018-08-09
- **Last Updated**: 2023-05-04

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: None

## README

# Think GraphQL
Better GraphQL SDK for thinkphp 5

## 文档

这里是本项目的[文档地址](https://smilecc.github.io/think-graphql/)，建议您阅读后再进一步使用。

如果您不知道GraphQL是什么，建议您阅读[GraphQL的官方文档](http://graphql.cn/)。

## 声明

1. 使用GraphQL需要您事先了解GraphQL的运作机制。

2. 本项目是在`graphql-php`的基础上二次封装，所有的Type都完全兼容`graphql-php`。

3. 在使用前建议您阅读文档、[查看Demo](https://github.com/smilecc/think-graphql-demo)来了解使用方法。

## 安装

```bash
$ composer require smilecc/think-graphql:dev-master
```
注意：由于ThinkPHP 5.1对比5.0有较大改变，所以目前只支持新版5.1。

## 使用

首先需要在`/application/command.php`中增加一个指令。

```php
<?php

return [
    'smilecc\think\GraphQLCommand'
];
```

然后在项目根目录下使用如下命令初始化框架

```bash
$ php think graph init
```

运行该命令之后如果提示初始化成功，则可以在`/config/graph.php`看到生成出的配置文件，以及在`/application/http/graph`文件夹下生成出的实例项目。

在初始化完毕之后，你可以使用GraphQL的测试工具请求`http://localhost/api/graph`进行尝试，正确安装的情况下会有如下的响应。

Query内容：
```
{
    user(id: 1){
    id
    nickname
    created_time
  }
}
```

响应内容：
```json
{
  "data": {
    "user": {
      "id": "1",
      "nickname": "TestUser",
      "created_time": "1533028910"
    }
  }
}
```

## 最后

如果您有任何的疑问和建议可以在Issues中反馈给我。

## 讨论群
如果有不懂或疑问，欢迎加入Q群进行交流，在加群之前请您知悉。

- 请勿发广告、推广、发黄赌毒等不和谐言语。
- Bug等相关问题仍需提Issues，我会尽快处理，目的是更好的为其他开发者提供参考。

![](https://i.loli.net/2018/09/25/5ba9cfd1467e4.png)