webonyx/graphql-php

Added

• Open ReferenceExecutor for extending

Fixed

• Ensure properties annotated to hold NodeList are not null
• Validate that directive argument names do not use reserved or duplicate names

Fixed

• Fix Input Object field shortcut definition with callable (https://github.com/webonyx/graphql-php/issues/773)

Added

• Implement support for interfaces implementing interfaces (https://github.com/webonyx/graphql-php/issues/740), huge kudos to @Kingdutch

Deprecates:

• Constant BreakingChangeFinder::BREAKING_CHANGE_INTERFACE_REMOVED_FROM_OBJECT. Use BreakingChangeFinder::BREAKING_CHANGE_IMPLEMENTED_INTERFACE_REMOVED instead. Constant value also changed from INTERFACE_REMOVED_FROM_OBJECT to IMPLEMENTED_INTERFACE_REMOVED.

• Constant BreakingChangeFinder::DANGEROUS_CHANGE_INTERFACE_ADDED_TO_OBJECT Use DANGEROUS_CHANGE_IMPLEMENTED_INTERFACE_ADDED instead. Constant value also changed from INTERFACE_ADDED_TO_OBJECT to IMPLEMENTED_INTERFACE_ADDED.

Refactoring:

• Reify AST node types and remove unneeded nullability (https://github.com/webonyx/graphql-php/issues/751)

Fixed

• Allow pushing nodes to NodeList via []= (https://github.com/webonyx/graphql-php/issues/767)
• Fix signature of Error\FormattedError::prepareFormatter() to address PHP8 deprecation (https://github.com/webonyx/graphql-php/issues/742)
• Do not add errors key to result when errors discarded by custom error handler (https://github.com/webonyx/graphql-php/issues/766)

Fixed

• Fixed SchemaPrinter so that it uses late static bindings when extended
• Parse DirectiveDefinitionNode->locations as NodeList<NamedNode> (fixes AST::fromArray conversion) (https://github.com/webonyx/graphql-php/issues/723)
• Parse Parser::implementsInterfaces as NodeList<NamedTypeNode> (fixes AST::fromArray conversion)
• Fix signature of Parser::unionMemberTypes to match actual NodeList<NamedTypeNode>

Added

• Allow typeLoader to return a type thunk (https://github.com/webonyx/graphql-php/issues/687)

Fixed

• Read getParsedBody() instead of getBody() when Request is ServerRequest (https://github.com/webonyx/graphql-php/issues/715)
• Fix default get/set behavior on InputObjectField and FieldDefinition (https://github.com/webonyx/graphql-php/issues/716)

Deprecates:

• Public access to FieldDefinition::$type property (https://github.com/webonyx/graphql-php/issues/702)

Fixes:

• Fix validation for input field definition directives (https://github.com/webonyx/graphql-php/issues/714)

Fixed

• Handle nullable DirectiveNode#astNode in SchemaValidationContext (https://github.com/webonyx/graphql-php/issues/708)

Added

• Add partial parse functions for const variants (https://github.com/webonyx/graphql-php/issues/693)

Fixed

• Differentiate between client-safe and non-client-safe errors in scalar validation (https://github.com/webonyx/graphql-php/issues/706)
• Proper type hints for IntValueNode (https://github.com/webonyx/graphql-php/issues/691)
• Fix "only booleans are allowed" errors (https://github.com/webonyx/graphql-php/issues/659)
• Ensure NamedTypeNode::$name is always a NameNode (https://github.com/webonyx/graphql-php/issues/695)

Optimized

• Visitor: simplify getVisitFn (https://github.com/webonyx/graphql-php/issues/694)
• Replace function calls with type casts (https://github.com/webonyx/graphql-php/issues/692)

Optimized

• Optimize lazy types (https://github.com/webonyx/graphql-php/issues/684)

Fixed

• Fix for: Argument defaults with integer/float values crashes introspection query (https://github.com/webonyx/graphql-php/issues/679)
• Fix for "Invalid AST Node: false" error (https://github.com/webonyx/graphql-php/issues/685)
• Fix double Error wrapping when parsing variables (https://github.com/webonyx/graphql-php/issues/688)

Optimized

• Do not use call_user_func or call_user_func_array (https://github.com/webonyx/graphql-php/issues/676)
• Codestyle and static analysis improvements (https://github.com/webonyx/graphql-php/issues/648, https://github.com/webonyx/graphql-php/issues/690)

This release brings several breaking changes. Please refer to UPGRADE document for details.

• BREAKING/BUGFIX: Strict coercion of scalar types (https://github.com/webonyx/graphql-php/issues/278)
• BREAKING/BUGFIX: Spec-compliance: Fixed ambiguity with null variable values and default values (https://github.com/webonyx/graphql-php/issues/274)
• BREAKING: Removed deprecated directive introspection fields (onOperation, onFragment, onField)
• BREAKING: GraphQL\Deferred now extends GraphQL\Executor\Promise\Adapter\SyncPromise
• BREAKING: renamed several types of dangerous/breaking changes (returned by BreakingChangesFinder)
• BREAKING: Renamed GraphQL\Error\Debug to GraphQL\Error\DebugFlag.
• BREAKING: Debug flags in GraphQL\Executor\ExecutionResult, GraphQL\Error\FormattedError and GraphQL\Server\ServerConfig do not accept boolean value anymore but int only.
• BREAKING: $positions in GraphQL\Error\Error constructor are not nullable anymore. Same can be expressed by passing an empty array.

Added

• Support repeatable directives (https://github.com/webonyx/graphql-php/issues/643)
• Support SDL Validation and other schema validation improvements (e.g. https://github.com/webonyx/graphql-php/issues/492)
• Added promise adapter for Amp (https://github.com/webonyx/graphql-php/issues/551)
• Query plan utility improvements (https://github.com/webonyx/graphql-php/issues/513, https://github.com/webonyx/graphql-php/issues/632)
• Allow retrieving query complexity once query has been completed (https://github.com/webonyx/graphql-php/issues/316)
• Allow input types to be passed in from variables using \stdClass instead of associative arrays (https://github.com/webonyx/graphql-php/issues/535)
• Support UTF-16 surrogate pairs within string literals (https://github.com/webonyx/graphql-php/issues/554, https://github.com/webonyx/graphql-php/issues/556)

Changed

• Compliant with the GraphQL specification June 2018 Edition
• Having an empty string in deprecationReason will now print the @deprecated directive (only a null deprecationReason won't print the @deprecated directive).

Optimized

• Perf: support lazy type definitions (https://github.com/webonyx/graphql-php/issues/557)
• Simplified Deferred implementation (now allows chaining like promises, https://github.com/webonyx/graphql-php/issues/573)

Deprecated

• Deprecated Experimental executor (https://github.com/webonyx/graphql-php/issues/397)

Fixed

• Some bugs
• Improve accuracy of type hints with PHPStan

Special thanks to @simPod, @spawnia and @shmax for their major contributions!

• Fix double Error wrapping when parsing variables (https://github.com/webonyx/graphql-php/issues/689)

• Don't call global field resolver on introspection fields (https://github.com/webonyx/graphql-php/issues/481)

• Added retrieving query complexity once query has been completed (https://github.com/webonyx/graphql-php/issues/316)
• Allow input types to be passed in from variables using \stdClass instead of associative arrays (https://github.com/webonyx/graphql-php/issues/535)

• QueryPlan can now be used on interfaces not only objects. (https://github.com/webonyx/graphql-php/issues/495)
• Array in variables in place of object shouldn't cause fatal error (fixes https://github.com/webonyx/graphql-php/issues/467)
• Scalar type ResolverInfo::getFieldSelection support (https://github.com/webonyx/graphql-php/issues/529)

• Fix coroutine executor when using with promise (https://github.com/webonyx/graphql-php/issues/486)

• Force int when setting max query depth (https://github.com/webonyx/graphql-php/issues/477)

• Reverted minor possible breaking change (https://github.com/webonyx/graphql-php/issues/476)

• Added QueryPlan support (https://github.com/webonyx/graphql-php/issues/436)
• Fixed an issue with NodeList iteration over missing keys (https://github.com/webonyx/graphql-php/issues/475)

• Better validation of field/directive arguments
• Support for apollo client/server persisted queries
• Minor tweaks and fixes

This release brings several breaking changes. Please refer to UPGRADE document for details.

New features and notable changes:

• PHP version required: 7.1+
• Spec compliance: error category and extensions are displayed under extensions key when using default formatting (https://github.com/webonyx/graphql-php/issues/389)
• New experimental executor with improved performance (https://github.com/webonyx/graphql-php/issues/314).<br> It is a one-line switch: GraphQL::useExperimentalExecutor().<br> <br> Please try it and post your feedback at https://github.com/webonyx/graphql-php/issues/397 (as it may become the default one in future) <br> <br>
• Ported extendSchema from the reference implementation under GraphQL\Utils\SchemaExtender (https://github.com/webonyx/graphql-php/issues/362)
• Added ability to override standard types via GraphQL::overrideStandardTypes(array $types) (https://github.com/webonyx/graphql-php/issues/401)
• Added flag Debug::RETHROW_UNSAFE_EXCEPTIONS which would only rethrow app-specific exceptions (https://github.com/webonyx/graphql-php/issues/337)
• Several classes were renamed (see UPGRADE.md)
• Schema Validation improvements

• Bugfix: Call to a member function getLocation() on null (https://github.com/webonyx/graphql-php/issues/336)
• Fixed several errors discovered by static analysis (https://github.com/webonyx/graphql-php/issues/329)

• Execution performance optimization for lists

• Allow stringeable objects to be serialized by StringType (https://github.com/webonyx/graphql-php/issues/303)

• StandardServer: add support for the multipart/form-data content type (https://github.com/webonyx/graphql-php/issues/300)

• SchemaPrinter: Use multi-line block for trailing quote (https://github.com/webonyx/graphql-php/issues/294)

• Fixed bug in validation rule OverlappingFieldsCanBeMerged (https://github.com/webonyx/graphql-php/issues/292)
• Added one more breaking change note in UPGRADE.md (https://github.com/webonyx/graphql-php/issues/291)
• Spec compliance: remove data entry from response on top-level error (https://github.com/webonyx/graphql-php/issues/281)

• RFC: Block String (multi-line strings via triple-quote """string""")
• GraphQL Schema SDL: Descriptions as strings (including multi-line)
• Changed minimum required PHP version to 5.6

Improvements:

• Allow extending GraphQL errors with additional properties
• Fixed parsing of default values in Schema SDL
• Handling several more cases in findBreakingChanges
• StandardServer: expect operationName (instead of operation) in input

• Allow objects with __toString in IDType

• findBreakingChanges utility (see https://github.com/webonyx/graphql-php/issues/199)

• StandardServer: Support non pre-parsed PSR-7 request body (see https://github.com/webonyx/graphql-php/issues/202)

• Bugfix: provide descriptions to custom scalars (see https://github.com/webonyx/graphql-php/issues/181)

• Ability to override internal types via types option of the schema (see https://github.com/webonyx/graphql-php/issues/174).

This release brings little changes but there are two reasons why it is released as major version:

1. To follow reference implementation versions (it matches 0.11.x series of graphql-js)
2. It may break existing applications because scalar input coercion rules are stricter now:<br> In previous versions sloppy client input could leak through with unexpected results. For example string "false" accidentally sent in variables was converted to boolean true and passed to field arguments. In the new version, such input will produce an error (which is a spec-compliant behavior).

Improvements:

• Stricter input coercion (see https://github.com/webonyx/graphql-php/issues/171)
• Types built with BuildSchema now have reference to AST node with corresponding AST definition (in $astNode property)
• Account for query offset for error locations (e.g. when query is stored in .graphql file)

• StandardServer improvement: do not raise an error when variables are passed as empty string (see https://github.com/webonyx/graphql-php/issues/156)

• Fixed infinite loop in the server (see https://github.com/webonyx/graphql-php/issues/153)

This release brings several breaking changes. Please refer to UPGRADE document for details.

New features and notable changes:

• Changed minimum PHP version from 5.4 to 5.5
• Lazy loading of types without separate build step (see https://github.com/webonyx/graphql-php/issues/69, see docs)
• PSR-7 compliant Standard Server (see docs)
• New default error formatting, which does not expose sensitive data (see docs)
• Ability to define custom error handler to filter/log/re-throw exceptions after execution (see docs)
• Allow defining schema configuration using objects with fluent setters vs array (see docs)
• Allow serializing AST to array and re-creating AST from array lazily (see docs)
• Apollo-style query batching support via server (see docs)
• Schema validation, including validation of interface implementations (see docs)
• Ability to pass custom config formatter when defining schema using GraphQL type language (see docs)

Improvements:

• Significantly improved parser performance (see https://github.com/webonyx/graphql-php/issues/137 and https://github.com/webonyx/graphql-php/issues/128)
• Support for PHP7 exceptions everywhere (see https://github.com/webonyx/graphql-php/issues/127)
• Improved documentation and docblock comments

Deprecations and breaking changes - see UPGRADE document.

• Minor change to assist DataLoader project in fixing https://github.com/webonyx/graphql-php/issues/150

• Fixed PHP notice and invalid conversion when non-scalar value is passed as ID or String type (see https://github.com/webonyx/graphql-php/issues/121)

• Fixed bug occurring when enum value is bool, null or float (see https://github.com/webonyx/graphql-php/issues/141)

• Ability to disable introspection (see https://github.com/webonyx/graphql-php/issues/131)

• Fixed issue with query complexity throwing on invalid queries (see https://github.com/webonyx/graphql-php/issues/125)
• Fixed "Out of memory" error when resolveType returns unexpected result (see https://github.com/webonyx/graphql-php/issues/119)

• Bugfix: throw UserError vs InvariantViolationError for errors caused by client (see https://github.com/webonyx/graphql-php/issues/123)

• Bugfix: use directives when calculating query complexity (see https://github.com/webonyx/graphql-php/issues/113)
• Bugfix: AST\Node::__toString() will convert node to array recursively to encode to json without errors

• Bugfix: ResolveInfo::getFieldSelection() now correctly merges fragment selections (see https://github.com/webonyx/graphql-php/issues/98)

• Bugfix: ResolveInfo::getFieldSelection() now respects inline fragments

• Fixed SyncPromiseAdapter::all() to not change the order of arrays (see https://github.com/webonyx/graphql-php/issues/92)

• Tools to help building schema out of Schema definition language as well as printing existing schema in Schema definition language (see https://github.com/webonyx/graphql-php/issues/91)

• Fixed Utils::assign() bug related to detecting missing required keys (see https://github.com/webonyx/graphql-php/issues/89)

• Schema Definition Language: element descriptions can be set through comments (see https://github.com/webonyx/graphql-php/issues/88)

• Fixed: GraphQL\Server now properly sets promise adapter before executing query

• Deferred resolvers (see https://github.com/webonyx/graphql-php/issues/66, see docs)
• New Facade class with fluid interface: GraphQL\Server (see https://github.com/webonyx/graphql-php/issues/82)
• Experimental: ability to load types in Schema lazily via custom TypeResolutionStrategy (see https://github.com/webonyx/graphql-php/issues/69)

This release brings several minor breaking changes. Please refer to UPGRADE document for details.

New features:

• Support for null value (as required by latest GraphQL spec)
• Shorthand definitions for field and argument types (see https://github.com/webonyx/graphql-php/issues/47)
• path entry in errors produced by resolvers for better debugging
• resolveType for interface/union is now allowed to return string name of type
• Ability to omit name when extending type class (vs defining inline)

Improvements:

• Spec compliance improvements
• New docs and examples