This Symfony bundle adds a GraphQL server to eZ Platform, the Open Source CMS. It exposes two endpoints.
https://<host>/graphql
A graph of the repository's domain. It exposes the domain modelled using the repository, based on content types groups, content types and fields definitions. Use it to implement apps or sites dedicated to a given repository structure.
Example: an eZ Platform site.
Warning: this feature requires extra configuration steps. See the Domain Schema documentation.
https://<host>/graphql/repository
A graph of the repository's Public API. It exposes value objects from the repository: content, location, field, url alias... It is recommended for admin like applications, not limited to a particular repository.
Example: an eZ Platform Admin UI extension.
Repository schema documentation
Install the package and its dependencies using composer:
composer require bdunogier/ezplatform-graphql-bundle
Add the bundles to app/AppKernel.php
(pay attention to the order, it is important):
$bundles = array(
// ...
new BD\EzPlatformGraphQLBundle\BDEzPlatformGraphQLBundle(),
new Overblog\GraphQLBundle\OverblogGraphQLBundle(),
new AppBundle\AppBundle(),
);
Add the GraphQL routing configuration to app/config/routing.yml
:
overblog_graphql:
resource: "@OverblogGraphQLBundle/Resources/config/routing/graphql.yml"
overblog_graphql_endpoint:
path: /graphql
defaults:
_controller: Overblog\GraphQLBundle\Controller\GraphController::endpointAction
_format: "json"
Run the command that generates the GraphQL schema:
php bin/console ezplatform:graphql:generate-schema
php bin/console cache:clear
It will generate a lot of yaml files in app/config/graphql/ezplatform
, based on your content types.
The graphical graphQL client, GraphiQL, must be installed separately if you want to use it. As a developer, you probably want to.
composer require --dev overblog/graphiql-bundle
Add OverblogGraphiQLBundle
to the dev
bundles:
case 'dev':
// ...
$bundles[] = new Overblog\GraphiQLBundle\OverblogGraphiQLBundle();
Add the GraphiQL route to app/config/routing_dev.yml
:
overblog_graphql_graphiql:
resource: "@OverblogGraphiQLBundle/Resources/config/routing.xml"
Open http://<yourhost>/graphiql
.