webonyx/graphql-php

Added

• Allow native PHP enums as return values for SDL-based enums https://github.com/webonyx/graphql-php/pull/1608

Added

• Serialize valid \BackedEnum values in GraphQL\Type\Definition\PhpEnumType https://github.com/webonyx/graphql-php/pull/1604

Fixed

• Avoid infinite recursion in QueryDepth validator https://github.com/webonyx/graphql-php/pull/1581

Fixed

• Ensure unaliasedPath does not grow for each list item https://github.com/webonyx/graphql-php/pull/1579

Fixed

• Avoid crash by triggering side effect via count on PHPUnit\Framework\Test https://github.com/webonyx/graphql-php/pull/1577

Changed

• Optimize and deduplicate ReferenceExecutor https://github.com/webonyx/graphql-php/pull/1572

Fixed

• Remove redundant code in ReferenceExecutor https://github.com/webonyx/graphql-php/pull/1570

Added

• Add property unaliasedPath to ResolveInfo https://github.com/webonyx/graphql-php/pull/1548

Fixed

• Fix ScopedContext for mutations https://github.com/webonyx/graphql-php/pull/1549

Fixed

• Count new lines when parsing multi-line comments https://github.com/webonyx/graphql-php/pull/1538

Changed

• Allow scalars from BuildClientSchema to have any type https://github.com/webonyx/graphql-php/pull/1536

Changed

• The standard server now produces distinct exception classes instead of generic RequestError https://github.com/webonyx/graphql-php/pull/1533

Fixed

• Allow enum instances in PhpEnumType::parseValue() https://github.com/webonyx/graphql-php/pull/1519

Added

• Support react/promise v3 https://github.com/webonyx/graphql-php/pull/1517

Fixed

• Correctly print deprecated argument with default value https://github.com/webonyx/graphql-php/pull/1491

Added

• Early return when complexity is disabled https://github.com/webonyx/graphql-php/pull/1475
• Allow access to calculated query complexity https://github.com/webonyx/graphql-php/pull/1475

Fixed

• Fix PHPStan definition for SchemaConfig option types https://github.com/webonyx/graphql-php/pull/1479

Added

• Control field visibility through option visible https://github.com/webonyx/graphql-php/pull/1434

Fixed

• Fix printing of single line descriptions with Unicode https://github.com/webonyx/graphql-php/pull/1436

Fixed

• Avoid instantiations when checking if types are built-in https://github.com/webonyx/graphql-php/pull/1423

Fixed

• Allow lazy root type callables to return null https://github.com/webonyx/graphql-php/pull/1422

Added

• Allow lazy root types query, mutation, subscription https://github.com/webonyx/graphql-php/pull/1418

Fixed

• Also set queryId from Apollo-source sha256Hash if query is provided https://github.com/webonyx/graphql-php/pull/1412

Fixed

• Do not set raw vars on query complexity rule if no validation rules are used https://github.com/webonyx/graphql-php/pull/1413

Fixed

• Remove useless and broken Parser::document(), use parse()

Added

• Add ScopedContext interface to control cloning of the context value

Added

• Allow deprecating input fields and arguments https://github.com/webonyx/graphql-php/pull/1382

Fixed

• Call static methods in SchemaPrinter with static:: to enable overrides

Fixed

• Allow sending both query and queryId, let persistedQueryLoader handle it https://github.com/webonyx/graphql-php/pull/1372

Added

• Provide a custom name for the Enum generated by PhpEnumType https://github.com/webonyx/graphql-php/pull/1368

Fixed

• Merge selected fields in ResolveInfo::getFieldSelection() https://github.com/webonyx/graphql-php/pull/1365

Fixed

• Ensure OperationDefinitionNode.variableDefinitions is initialized

Fixed

• Annotate @throws accurately

Fixed

• Improve handling of JSON encoding errors

Fixed

• Initialize directives and arguments in Node with empty NodeList

Changed

• Improve validation messages for type definitions

Added

• Add additional sorting options to SchemaPrinter

Fixed

• Fix QueryPlan for union types

Changed

• Improve QueryPlan performance

Fixed

• Fix QueryPlan when querying __typename on a union type

Fixed

• Fix printing of single line descriptions with backslashes

Changed

• Print long argument lists on multiple lines
• Print space between object value brackets

Changed

• PHP version required: 7.4+
• Propagate error message and stack trace for why leaf value serialization failed
• Do not throw client safe Error when failing to serialize an Enum type
• Use native PHP types for properties of Type and its subclasses
• Throw SerializationError over client safe Error when failing to serialize leaf types
• Move debug entries in errors under extensions key
• Use native PHP types wherever possible
• Always throw RequestError with useful message when clients provide an invalid JSON body
• Move class BlockString from namespace GraphQL\Utils to GraphQL\Language
• Return string-keyed arrays from GraphQL::getStandardDirectives(), GraphQL::getStandardTypes() and GraphQL::getStandardValidationRules()
• Move complexity related code from FieldDefinition to QueryComplexity
• Exclude unused standard types from the schema
• Require lazy type loader to return Type directly without an intermediary callable
• Allow lazy type loader to return null
• Rename ServerConfig option persistentQueryLoader to persistedQueryLoader
• Call previously unused methods EnumType::parseValue() and EnumType::parseLiteral()
• Strongly type PromiseAdapter::createRejected() to require \Throwable
• Move members specific to NamedType out of Type: $name, $description, $config, isBuiltInType(), assertValid()
• Always convert recursively when calling Node::toArray()
• Make Directive::$config['args'] use the same definition style as FieldDefinition::$config['args']
• Rename FieldArgument to Argument
• Make errors when parsing scalar literals more precise
• Change expected QueryPlan options from ['group-implementor-fields'] to ['groupImplementorFields' => true] in ResolveInfo::lookAhead()
• Always convert promises through PromiseAdapter::convertThenable() before calling ->then() on them
• Use JSON_THROW_ON_ERROR in json_encode()
• Validate some internal invariants through assert()
• PromiseAdapter::all() accepts iterable
• Throw if Introspection::fromSchema() returns no data
• Reorganize abstract class ASTValidationContext to interface ValidationContext
• Reorganize AST interfaces related to schema and type extensions
• Align Utils::suggestionList() with the reference implementation (https://github.com/webonyx/graphql-php/issues/1075)
• Order schema topologically and according to the user-defined order, affects introspection and printing
• GraphQL\Utils\AST::typeFromAST() now needs a type loader callable instead of the Schema
• Do not change HTTP status code in StandardServer
• Use " instead of """ for single line descriptions
• Make Helper::emitResponse() private, use Helper::sendResponse()
• Emit unescaped UTF-8 from StandardServer
• Sync input value coercion with graphql-js reference implementation
• Store rules exclusively by class name in DocumentValidator
• Reorder standard types as described in the GraphQL specification
• Improve runtime performance by moving checks for duplicate/mismatching type instances to assert() or schema validation
• Replace HasSelectionSet::$selectionSet with HasSelectionSet::getSelectionSet()
• Replace TypeDefinitionNode::$name with TypeDefinitionNode::getName()
• Replace TypeExtensionNode::$name with TypeExtensionNode::getName()

Added

• Improve extendability of validator rules
• Add tests for errors that occur when undeclared fields are passed in input
• Warn about orphaned object types
• Expose structured enumeration of directive locations
• Add AST::concatAST() utility
• Allow lazy input object fields
• Add validation rule UniqueEnumValueNames
• Add SDL validation rule UniqueOperationTypes (https://github.com/webonyx/graphql-php/issues/995)
• Add ability to remove custom validation rules after adding them via DocumentValidator::removeRule()
• Allow lazy enum values
• Make Node implement JsonSerializable
• Add SDL validation rule UniqueTypeNames (https://github.com/webonyx/graphql-php/issues/998)
• Add support for SDL validation to KnownTypeNames rule (https://github.com/webonyx/graphql-php/issues/999)
• Add SDL validation rule UniqueArgumentDefinitionNames (https://github.com/webonyx/graphql-php/issues/1136)
• Add parseValue config option to InputObjectType to parse input value to custom value object
• Add option sortTypes to have SchemaPrinter order types alphabetically
• Allow constructing EnumType from PHP enum
• Add TypeInfo::getParentTypeStack() and TypeInfo::getFieldDefStack()
• Include path to faulty input in coercion errors
• Add ability to resolve abstract type of object via __typename

Optimized

• Use recursive algorithm for printer and improve its performance
• Use foreach over slower functions array_map() and Utils::map()

Fixed

• Avoid QueryPlan crash when multiple $fieldNodes are present
• Allow instantiating multiple QueryPlan with different options
• Clarify error when attempting to coerce anything but array or stdClass to an input object
• Allow directives on variable definitions
• Handle null parent of list in ValuesOfCorrectType::getVisitor
• Allow sending both query and queryId, ignore queryId in that case
• Preserve extended methods from class-based types in SchemaExtender::extend()
• Fix printing of empty types (https://github.com/webonyx/graphql-php/issues/940)
• Clone NodeList in Node::cloneDeep()
• Calling Schema::getType() on a schema built from SDL returns null for unknown types (https://github.com/webonyx/graphql-php/issues/1068)
• Avoid crash on typeless inline fragment when using QueryComplexity rule
• Avoid calling FormattedError::addDebugEntries() twice when using default error formatting
• Avoid calling defined functions named like lazily loaded types
• Show actual error in debug entries
• Deal with iterable in implementations of PromiseAdapter::all()

Removed

• Remove OperationParams method getOriginalInput() in favor of public property $originalInput
• Remove OperationParams method isReadOnly() in favor of public property $readOnly
• Remove Utils::withErrorHandling()
• Remove TypeComparators::doTypesOverlap()
• Remove DocumentValidator::isError()
• Remove DocumentValidator::append()
• Remove Utils::getVariableType() in favor of Utils::printSafe()
• Remove warning for passing isDeprecated in field definition config
• Remove WrappingType::getWrappedType() argument $recurse in favor of WrappingType::getInnermostType()
• Remove Type::assertType()
• Remove ListOfType::$ofType, ListOfType::getOfType() and NonNull::getOfType()
• Remove option commentDescriptions from BuildSchema::buildAST(), BuildSchema::build() and Printer::doPrint()
• Remove parameter $options from ASTDefinitionBuilder
• Remove FieldDefinition::create() in favor of new FieldDefinition()
• Remove GraphQL\Exception\InvalidArgument
• Remove Utils::find(), Utils::every() and Utils::invariant()
• Remove argument bool $exitWhenDone from StandardServer::send500Error() and StandardServer::handleRequest()
• Remove Schema::getAstNode() in favor of Schema::$astNode
• Remove ability to override standard types through Schema option types, use Type::overrideStandardTypes()
• Remove GraphQL\Utils\TypeInfo::typeFromAST(), use GraphQL\Utils\AST::typeFromAST()
• Remove StandardServer::send500Error(), handle non-GraphQL errors yourself
• Remove StandardServer::getHelper(), use new Helper
• Remove error extension field category, use custom error formatting if you still need it
• Remove deprecated Type::getInternalTypes()
• Remove deprecated GraphQL::execute()
• Remove deprecated GraphQL::executeAndReturnResult()
• Remove deprecated experimental CoroutineExecutor
• Remove deprecated FormattedError::create() and FormattedError::createFromPHPError()
• Remove deprecated GraphQL::setPromiseAdapter()
• Remove deprecated AST::getOperation()
• Remove deprecated constants from BreakingChangesFinder
• Remove deprecated DocumentValidator::isValidLiteralValue()
• Remove deprecated Error::formatError() and Error::toSerializableArray()
• Remove deprecated GraphQL::getInternalDirectives()
• Remove deprecated Schema::isPossibleType()
• Remove deprecated methods from TypeInfo
• Remove deprecated Values::valueFromAST() and Values::isValidPHPValue()
• Remove deprecated public property access to InputObjectField::$type
• Remove deprecated public property access to FieldDefinition::$type
• Remove alias GraphQL\Validator\Rules\AbstractQuerySecurity, use GraphQL\Validator\Rules\QuerySecurityRule
• Remove alias GraphQL\Validator\Rules\AbstractValidationRule, use GraphQL\Validator\Rules\ValidationRule
• Remove alias GraphQL\Utils\FindBreakingChanges, use GraphQL\Utils\BreakingChangesFinder

Fixed

• Fix PHP 8.2 deprecated string interpolation syntax
• Fix PHP 8.2 deprecated dynamic properties

Fixed

• Accept AST where field arguments are not given

Fixed

• Correct the broken 14.11.7 release - see https://github.com/webonyx/graphql-php/issues/1221

Fixed

• Fix PHP 8.2 deprecation of "static" in callables

Fixed

• Fix validation of modified sparse ASTs

Fixed

• Fix extend() to preserve repeatable (https://github.com/webonyx/graphql-php/issues/931)

Fixed

• Fix repeatable directive validation for AST

Fixed

• Fix compatibility of more methods with native return type in PHP 8.1

Fixed

• Support non-JSON ServerRequestInterface

Fixed

• Fix compatibility of methods with native return type in PHP 8.1

Added

• Allow field definitions to be defined as any iterable, not just array

Added

• Make IntType constants MAX_INT and MIN_INT public

Added

• Add support for type config decorator in SchemaExtender

Added

• Implement GraphQL\Utils\AST::getOperationAST()