youshido-php / GraphQL

Pure PHP realization of GraphQL protocol
MIT License
710 stars 106 forks source link

Operation type directive is overriding directives defined in ancestor fields #242

Open leoloso opened 4 years ago

leoloso commented 4 years ago

In the following query, all directives declared in the ancestor fields are lost, only the ones in the leaf fields are parsed correctly from the AST:

query {
  ancestorField @thisDirectiveIsLost { 
    leafField @thisDirectiveWorksWell
  }
}

For instance, in this query the @include directive is lost, and title is included when it should not:

query {
  post(id:1) @include(if: false) { 
    title
  }
}

Inspecting the code, I found out that in Parser/Parser.php, function parseOperation, the operation type directive is being set into $operation:

$operation->setDirectives($directives);

However, the $operation already had its own directives, parsed through parseBodyItem. Hence, these are being overridden.

Merging the 2 sets of directives, instead, it works well:

$operation->setDirectives(array_merge(
    $directives,
    $operation->getDirectives()
));

Is that the right solution? Must directives defined next to the operation type be copied into all ancestor fields? And what about leaf fields, which currently have no problem with their own directives? (This solution seems to fix the bug, but I don't know if I may be creating another one? I can't find any reference in the GraphQL spec to what is the expected behavior for operation type directives...)

leoloso commented 4 years ago

To clarify: this bug also happens if no operation type directives were defined in the query; in that case, the overriding $directives is an empty array

leoloso commented 4 years ago

Ops, I closed by mistake.

This branch in my fork deals with this issue:

https://github.com/getpop/graphql-parser/tree/fix-overriding-directives

Jalle19 commented 4 years ago

Can you make a PR?

leoloso commented 4 years ago

Alright. I just added a test, will submit the PR now.

leoloso commented 4 years ago

The bug happens only when adding "query" at the beginning of the query:

query { 
  user @include(if:false) {
    name
   }
}

This query had no issue:

{ 
  user @include(if:false) {
    name
   }
}