/graphql

GraphQL integration for Drupal 8

Primary LanguagePHP

Introduction

Build Status Code Coverage Code Quality

GraphQL for Drupal

This module lets you craft and expose a GraphQL schema for Drupal 8.

It is is built around https://github.com/webonyx/graphql-php. As such, it supports the full official GraphQL specification with all its features.

You can use this module as a foundation for building your own schema through custom code or you can use and extend the generated schema using the plugin architecture and the provided plugin implementations form the sub-module.

For ease of development, it includes the GraphiQL interface at/graphql/explorer.

Installation

This module requires composer for installation. To install, simply run composer require drupal/graphql.

Quickstart

To get a quick overview from the query part of GraphQL in action watch the following video's.

Headless Drupal with GraphQL from scratch - part 01 Headless Drupal with GraphQL from scratch - part 02

Example implementation

Check out https://github.com/fubhy/drupal-decoupled-app for a complete example of a fully decoupled React and GraphQL application. Feel free to use that repository as a starting point for your own decoupled application.

Documentation

Documentation is heavily worked on, but still far from complete. This is due to the vast amount of improvements and additional features we've added to the module recently. As we are finishing up the 3.x version of this module we will be re-doing the documentation and record a series of screencasts.

These blog posts provide additional information on how to use and extend the module as well as other other contributed modules supporting it:

Resources

Related projects