overblog · Inego · Mar 13, 2018 · Mar 13, 2018 · Mar 22, 2018 · Mar 22, 2018
diff --git a/.travis.yml b/.travis.yml
@@ -31,18 +31,8 @@ script: composer test
 
 jobs:
     include:
-        - stage: Test
-          php: 5.6
-          env: COMPOSER_UPDATE_FLAGS=--prefer-lowest SYMFONY_DEPRECATIONS_HELPER=disabled GRAPHQLPHP_VERSION=^0.11.2
-        - php: 5.6
-          env: SYMFONY_VERSION=3.1.* SYMFONY_DEPRECATIONS_HELPER=disabled GRAPHQLPHP_VERSION=0.12
-        - php: 7.0
-          env: SYMFONY_VERSION=3.2.* PHPUNIT_VERSION=^5.7.26
-        - php: 7.1
         - php: 7.2
-          env: SYMFONY_VERSION=3.3.*
-        - php: 7.2
-          env: SYMFONY_VERSION=3.4.*
+          env: SYMFONY_VERSION=3.4.* GRAPHQLPHP_VERSION=^0.11.2
         - php: 7.2
           env: SYMFONY_VERSION=4.1.* STABILITY=beta
         - php: nightly

diff --git a/README.md b/README.md
@@ -17,10 +17,13 @@ It also supports:
 
 Browse your version documentation:
 
-* [0.8](https://github.com/overblog/GraphQLBundle/blob/0.8/README.md)
-* [0.9](https://github.com/overblog/GraphQLBundle/blob/0.9/README.md)
-* [0.10](https://github.com/overblog/GraphQLBundle/blob/0.10/README.md)
-* [0.11](https://github.com/overblog/GraphQLBundle/blob/0.11/README.md)
+* [0.8  (OBSOLETE)](https://github.com/overblog/GraphQLBundle/blob/0.8/README.md)
+* [0.9  (OBSOLETE)](https://github.com/overblog/GraphQLBundle/blob/0.9/README.md)
+* [0.10 (OBSOLETE)](https://github.com/overblog/GraphQLBundle/blob/0.10/README.md)
+* [0.11 (STABLE)](https://github.com/overblog/GraphQLBundle/blob/0.11/README.md)
+* [0.12 (DEV)](https://github.com/overblog/GraphQLBundle/blob/master/README.md)
+
+[Versions requirements](docs/index.md#versions-requirements)
 
 Documentation
 -------------
@@ -63,6 +66,7 @@ Documentation
   - [Promise](docs/data-fetching/promise.md)
 - [Security](docs/security/index.md)
   - [Handle CORS](docs/security/handle-cors.md)
+  - [Object access control](docs/security/object-access-control.md)
   - [Fields access control](docs/security/fields-access-control.md)
   - [Fields public control](docs/security/fields-public-control.md)
   - [Limiting query depth](docs/security/limiting-query-depth.md)
@@ -74,6 +78,8 @@ Documentation
 Talks and slides to help you start
 ----------------------------------
 
+* GraphQL in Symfony *by Bernd Alter* - [Twitter](https://twitter.com/bazoo0815)
+  - [Talk about GraphQL and its implementation with Symfony (26.04.2017)](https://www.slideshare.net/berndalter7/graphql-in-symfony) `English`
 * GraphQL is right in front of us, let's to it! *by Renato Mendes Figueiredo* - [Twitter](https://twitter.com/renatomefi), [GitHub](https://github.com/renatomefi)
   - [Slides at http://talks.mefi.in/graphql-scotphp17](http://talks.mefi.in/graphql-scotphp17/) `English`
   - [Video at SymfonyCamp UA 2017](https://www.youtube.com/watch?v=jyoYlnCPNgk) `English`

diff --git a/composer.json b/composer.json
@@ -30,16 +30,16 @@
         "sort-packages": true
     },
     "require": {
-        "php": ">=5.6",
+        "php": ">=7.1",
         "overblog/graphql-php-generator": "^0.7.0",
         "psr/log": "^1.0",
-        "symfony/config": "^3.1 || ^4.0",
-        "symfony/dependency-injection": "^3.1 || ^4.0",
-        "symfony/event-dispatcher": "^3.1 || ^4.0",
-        "symfony/expression-language": "^3.1 || ^4.0",
-        "symfony/framework-bundle": "^3.1 || ^4.0",
-        "symfony/options-resolver": "^3.1 || ^4.0",
-        "symfony/property-access": "^3.1 || ^4.0",
+        "symfony/config": "^3.4 || ^4.0",
+        "symfony/dependency-injection": "^3.4 || ^4.0",
+        "symfony/event-dispatcher": "^3.4 || ^4.0",
+        "symfony/expression-language": "^3.4 || ^4.0",
+        "symfony/framework-bundle": "^3.4 || ^4.0",
+        "symfony/options-resolver": "^3.4 || ^4.0",
+        "symfony/property-access": "^3.4 || ^4.0",
         "webonyx/graphql-php": "^0.11.2 || ^0.12.0"
     },
     "suggest": {
@@ -51,20 +51,20 @@
         "phpunit/phpunit": "^5.7.26 || ^6.0",
         "react/promise": "^2.5",
         "sensio/framework-extra-bundle": "^3.0",
-        "symfony/asset": "^3.1 || ^4.0",
-        "symfony/browser-kit": "^3.1 || ^4.0",
-        "symfony/console": "^3.1 || ^4.0",
-        "symfony/css-selector": "^3.1 || ^4.0",
-        "symfony/phpunit-bridge": "^3.1 || ^4.0",
-        "symfony/process": "^3.1 || ^4.0",
-        "symfony/security-bundle": "^3.1 || ^4.0",
-        "symfony/templating": "^3.1 || ^4.0",
-        "symfony/web-profiler-bundle": "^3.1 || ^4.0",
-        "symfony/yaml": "^3.1 || ^4.0"
+        "symfony/asset": "^3.4 || ^4.0",
+        "symfony/browser-kit": "^3.4 || ^4.0",
+        "symfony/console": "^3.4 || ^4.0",
+        "symfony/css-selector": "^3.4 || ^4.0",
+        "symfony/phpunit-bridge": "^3.4 || ^4.0",
+        "symfony/process": "^3.4 || ^4.0",
+        "symfony/security-bundle": "^3.4 || ^4.0",
+        "symfony/templating": "^3.4 || ^4.0",
+        "symfony/web-profiler-bundle": "^3.4 || ^4.0",
+        "symfony/yaml": "^3.4 || ^4.0"
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "0.11-dev"
+            "dev-master": "0.12-dev"
         }
     },
     "scripts": {

diff --git a/docs/definitions/expression-language.md b/docs/definitions/expression-language.md
@@ -1,7 +1,7 @@
 Expression language
 ===================
 
-All definitions configs entries can use expression language but it must be explicitly triggered using "@=" like prefix.
+All definition config entries can use expression language but it must be explicitly triggered using "@=" like prefix.
 
 **Functions description:**
 
@@ -43,11 +43,11 @@ Expression | Description | Scope
 Custom expression function
 --------------------------
 
-Custom expression function is easy as creating a tagged service.
-Adding useful expression function can help user create simple resolver without having to leave config file,
-this also improve performance by removing a useless external resolver call.
+Adding custom expression function is easy since all you need to do is create a tagged service.
+Expression functions can help user create simple resolver without having to leave config file,
+this also improves performance by removing a useless external resolver call.
 
-Here an example to add an custom expression equivalent to php `json_decode`:
+Here is an example to add a custom expression equivalent to php `json_decode`:
 
 ```php
 <?php
@@ -77,7 +77,7 @@ App\ExpressionLanguage\JsonDecode:
     tags: ['overblog_graphql.expression_function']
 ```
 
-Now `json_decode` can be use in schema:
+Now `json_decode` can be used in schema:
 
 ```yaml
 Object:
@@ -89,5 +89,5 @@ Object:
             resolve: "@=json_decode(value.json_data, true)['name']"
 ```
 
-**Tips**: At last if this is till no answer to all your needs, the expression language service can be custom
+**Tips**: At last if this is not an answer to all your needs, the expression language service can be customized
 using bundle configuration.
diff --git a/docs/definitions/graphql-schema-language.md b/docs/definitions/graphql-schema-language.md
@@ -8,32 +8,117 @@ or this [cheat sheet](https://github.com/sogko/graphql-shorthand-notation-cheat-
 
 #### Usage
 
+##### Define Types
+
+> [GraphQL documentation about types and fields](https://graphql.github.io/learn/schema/#object-types-and-fields).
+
+
 ```graphql
 # config/graphql/schema.types.graphql
 
-type Query {
-  bar: Foo!
-  baz(id: ID!): Baz
+type Character {
+  # Name of the character
+  name: String! 
+  # This character appears in those episodes
+  appearsIn: [Episode]!
 }
+```
+
+##### Define Enumeration types
 
-scalar Baz
+> [GraphQL documentation about Enumerations types](https://graphql.github.io/learn/schema/#enumeration-types).
 
-interface Foo {
-  # Description of my is_foo field
-  is_foo: Boolean
+```graphql
+# Enumeration of episodes
+enum Episode {
+  NEWHOPE
+  EMPIRE
+  JEDI
 }
-type Bar implements Foo {
-  is_foo: Boolean
-  user: User!
+```
+
+##### Define Interfaces
+
+> [GraphQL documentation about Interfaces](https://graphql.github.io/learn/schema/#interfaces).
+
+```graphql
+interface Character {
+  id: ID!
+  name: String!
+  friends: [Character]
+  appearsIn: [Episode]!
+}
+```
+
+```graphql
+type Human implements Character {
+  id: ID!
+  name: String!
+  friends: [Character]
+  appearsIn: [Episode]!
+  starships: [Starship]
+  totalCredits: Int
 }
 
-enum User {
-  TATA
-  TITI
-  TOTO
+type Droid implements Character {
+  id: ID!
+  name: String!
+  friends: [Character]
+  appearsIn: [Episode]!
+  primaryFunction: String
 }
 ```
 
+##### Define queries
+
+> [GraphQL documentation about Query type](https://graphql.github.io/learn/schema/#the-query-and-mutation-types).
+
+```graphql
+type RootQuery {
+  # Access all characters
+  characters: [Character]!
+}
+```
+
+Do not forget to configure your schema **query** type, as described in the [schema documentation](https://github.com/overblog/GraphQLBundle/blob/master/Resources/doc/definitions/schema.md).
+
+```yml
+overblog_graphql:
+    definitions:
+        schema:
+            query: RootQuery
+```
+
+##### Define mutations
+
+> [GraphQL documentation about Mutation type](https://graphql.github.io/learn/schema/#the-query-and-mutation-types).
+
+```graphql
+input CreateCharacter {
+  name: String!
+}
+
+input UpdateCharacter {
+  name: String!
+}
+
+type RootMutation {
+  createCharacter(character: CreateCharacter!): Character!
+  updateCharacter(characterId: ID!, character: UpdateCharacter!): Character!
+}
+```
+
+Do not forget to configure your schema **mutation** type, as described in the [schema documentation](https://github.com/overblog/GraphQLBundle/blob/master/Resources/doc/definitions/schema.md).
+
+```yml
+overblog_graphql:
+    definitions:
+        schema:
+            mutation: RootMutation
+```
+
+---
+
 When using this shorthand syntax, you define your field resolvers (and some more configuration) separately
 from the schema. Since the schema already describes all of the fields, arguments, and result types, the only
 thing left is a collection of callable that are called to actually execute these fields.

diff --git a/docs/definitions/mutation.md b/docs/definitions/mutation.md
@@ -1,6 +1,6 @@
 # Mutation
 
-Here an example without using relay:
+Here an example of mutation without using [relay](https://facebook.github.io/relay/):
 
 ```yaml
 Mutation:
@@ -34,4 +34,56 @@ IntroduceShipInput:
                 type: "String!"
 ```
 
+To implement the logic behind your mutation, you should create a new class that
+implements `MutationInterface` and `AliasedInterface` interfaces.
+
+```php
+<?php
+# src/GraphQL/Mutation/ShipMutation.php
+namespace App\GraphQL\Mutation;
+
+use Overblog\GraphQLBundle\Definition\Resolver\AliasedInterface;
+use Overblog\GraphQLBundle\Definition\Resolver\MutationInterface;
+
+class ShipMutation implements MutationInterface, AliasedInterface
+{
+    private $factionRepository;
+
+    public function __construct(FactionRepository $factionRepository) {
+        $this->factionRepository = $factionRepository;
+    }
+
+    public function createShip(string $shipName, int $factionId): array
+    {
+        // `$shipName` has the value of `args['input']['shipName']`
+        // `$factionId` has the value of `args['input']['factionId']`
+
+        // Do something with `$shipName` and `$factionId` ...
+        $ship    = new Ship($shipName);
+        $faction = $this->factionRepository->find($factionId);
+        $faction->addShip($ship);
+        // ...
+
+
+        // Then returns our payload, it should fits `IntroduceShipPayload` type
+        return [
+            'ship'    => $ship,
+            'faction' => $faction,
+        ];
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public static function getAliases()
+    {
+        return [
+            // `create_ship` is the name of the mutation that you SHOULD use inside of your types definition
+            // `createShip` is the method that will be executed when you call `@=resolver('create_ship')`
+            'createShip' => 'create_ship'
+        ];
+    }
+}
+```
+
 Here the same example [using relay mutation](relay/mutation.md).
diff --git a/docs/definitions/relay/connection.md b/docs/definitions/relay/connection.md
@@ -22,7 +22,7 @@ User:
                 resolve: '@=resolver("friends", [value, args])'
             friendsForward:
                 type: userConnection
-                argsBuilder: "Relay::ForwardConnection
+                argsBuilder: "Relay::ForwardConnection"
                 resolve: '@=resolver("friends", [value, args])'
             friendsBackward:
                 type: userConnection