NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #1228 most downloaded on Packagist
Laravel wrapper for PHP GraphQL
Latest stable
10.2.0
Last release 10 days ago
09 Nov 2026
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
103 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Readded support for validation in field arguments (with breaking change fix) \#630 / crissi
As always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Reverted "Add support for validation in field arguments" due to breaking changes reported
Unfortunately the 5.1.0 release introduced a regression which is now fixed
Sorry for the angst 😱
Add support for validation in field arguments \#608 / crissi
GraphQL::type #621 / stevelacey
See also Type modifiers in the READMEAs always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
Long delay for a new release for no particular reason 🎉
Long delay for a new release for no particular reason 🎉
Some internal changes might cause breaks, depending of your level of customization thus we bump the major number to not cause troubles.
Many thanks to all the contributors 🙇
Note: we're already bumping the major version as some of the contributions did internal refactoring, making it incompatible with the semver promise.
Note: we're already bumping the major version as some of the contributions did internal refactoring, making it incompatible with the semver promise.
Note: we're already bumping the major version as some of the contributions did internal refactoring, making it incompatible with the semver promise.
Note: we're already bumping the major version as some of the contributions did internal refactoring, making it incompatible with the semver promise.
Since 3.1.0 we've had a lot of contributions, some are breaking changes with semver thus we start off with a new major version 🎉
Since 3.1.0 we've had a lot of contributions, some are breaking changes with semver thus we start off with a new major version 🎉
Although past released already were, 4.0.0 is now officially compatible with the latest and greatest PHP 7.4 release.
Field #521 / georgebootgetValidator() #531 / mailspiceSince 3.1.0 we've had a lot of contributions, some are breaking changes with semver thus we start off with a new major version.
Since 3.1.0 we've had a lot of contributions, some are breaking changes with semver thus we start off with a new major version.
Field #521 / georgebootgetValidator() #531 / mailspiceAllow passing through the rootValue as an option \#492 / tuurbo
rootValue as an option #492 / tuurboAs always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
We're bumping the major version as this release contains two breaking changes:
We're bumping the major version as this release contains two breaking changes:
wrapType(), allowing to add more information for queries/mutations #496 / albertcitoauthorize changed, receiving not the exact same argumenst the resolver would #489 / mfn
public function authorize(array $args)public function authorize($root, array $args, $ctx, ResolveInfo $resolveInfo = null, Closure $getSelectFields = null): boolAs always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
This release allows it to be installed with Laravel 6.0
This release allows it to be installed with Laravel 6.0
The custom 'query' now receives the GraphQL context as the 3rd arg (same as any resolver) \#464 / mfn
'query' now receives the GraphQL context as the 3rd arg (same as any resolver) #464 / mfn$getSelectFields(int $depth) #472 / mfnAs always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
A small patch release after the recent major 2.* release, expected to be fully compatible.
A small patch release after the recent major 2.* release, expected to be fully compatible.
If you are new to the 2.* release, please see our Upgrade Guide from v1 to 2.*
'alias' to be a callback #452 / crissiAs always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation!
This is a new major release including breaking changes, bug fixes, performance improvements and better test coverage.
This is a new major release including breaking changes, bug fixes, performance improvements and better test coverage.
See our Upgrade Guide from v1 to 2.* for things to watch out
Except for the updates to readme/changelog, this release is identical with https://github.com/rebing/graphql-laravel/releases/tag/v2.0.0-RC5
UploadType now has to be added manually to the types in your schema if you want to use it
::getInstance() method is goneresolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)lazyload_types), improve performance on large type systems #405 but doens't work together with type aliases or paginate().make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367InputType support class which eventually replace $inputObject=true #363DB::raw() in alias fieldsgraphql service is requested, improving performance when having this library installed but not using it in certain workloads (pure artisan commands, non-GraphQL web requests, etc.) #427App\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjustedSupport\Field, Support\InterfaceType, Support\Mutation, Support\Query, Support\Type, Support\UnionType #357cdn.jsdelivr.net and cdnjs.cloudflare.comValidatorError: remove setter and make it a constructor arg, add getter and rely on contractsis_lumen with static class call \Rebing\GraphQL\Helpers::isLumenSelectFields and still generates correct SQL queries #415authorize() #413\Fluent dependency on \Rebing\GraphQL\Support\Field #431\Fluent dependency on \Rebing\GraphQL\Support\Type #389\Rebing\GraphQL\Support\Type::$instances\Rebing\GraphQL\Support\Type::$unionTypeThank you to all the contributors that helped make this release happen:
As always, we would like to thank all the contributors that opened issues, created pull requests or updated the documentation.
New makeenum command and dedicated EnumType, deprecating $enumObject=true in the Type class
The release cycle is noticeable slowing down, indicating that the next major release will be there soon!
lazyload_types by default, but depending on how the library used, this may create a negative DX as not all cases can be supported so we decided not to do it for now.graphql service is requested, improving performance when having this library installed but not using it in certain workloads (pure artisan commands, non-GraphQL web requests, etc.) #427SelectFields and still generates correct SQL queries #415\Fluent dependency on \Rebing\GraphQL\Support\Field #431Please report and issues you find or hop on slack and give us feedback!
This covers the changes since the last stable release of the v1 release line, v1.24.0
UploadType now has to be added manually to the types in your schema if you want to use it
::getInstance() method is goneresolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)lazyload_types), improve performance on large type systems #405 but doens't work together with type aliases or paginate().make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367InputType support class which eventually replace $inputObject=true #363DB::raw() in alias fieldsgraphql service is requested, improving performance when having this library installed but not using it in certain workloads (pure artisan commands, non-GraphQL web requests, etc.) #427App\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjustedSupport\Field, Support\InterfaceType, Support\Mutation, Support\Query, Support\Type, Support\UnionType #357cdn.jsdelivr.net and cdnjs.cloudflare.comValidatorError: remove setter and make it a constructor arg, add getter and rely on contractsis_lumen with static class call \Rebing\GraphQL\Helpers::isLumenSelectFields and still generates correct SQL queries #415authorize() #413New makeenum command and dedicated EnumType, deprecating $enumObject=true in the Type class
Thanks to the hard work of @crissi , RC4 gives the power of performance!
lazyload_types config, set it true for better performance but witness you can't use aliasing with it!authorize() #413Please report and issues you find or hop on slack and give us feedback!
This covers the changes since the last stable release of the v1 release line, v1.24.0
resolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)UploadType now has to be added manually to the types in your schema if you want to use it
::getInstance() method is goneresolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367InputType support class which eventually replace $inputObject=true #363DB::raw() in alias fieldsApp\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjustedSupport\Field, Support\InterfaceType, Support\Mutation, Support\Query, Support\Type, Support\UnionType #357cdn.jsdelivr.net and cdnjs.cloudflare.comValidatorError: remove setter and make it a constructor arg, add getter and rely on contractsis_lumen with static class call \Rebing\GraphQL\Helpers::isLumenauthorize() #413\Fluent dependency on \Rebing\GraphQL\Support\Type\Rebing\GraphQL\Support\Type::$instances\Rebing\GraphQL\Support\Type::$unionTypeNew makeenum command and dedicated EnumType, deprecating $enumObject=true in the Type class
Quick on the heels of RC2, here's the third Release Candidate of the v2 release line!
There was only a minor change since the last release but nevertheless one important to reach people about the possible impact.
UploadType now has to be added manually to the types in your schema if you want to use it
::getInstance() method is gonePlease report and issues you find or hop on slack and give us feedback!
This covers the changes since the last stable release of the v1 release line, v1.24.0
resolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367InputType support class which eventually replace $inputObject=true #363DB::raw() in alias fieldsApp\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjustedSupport\Field, Support\InterfaceType, Support\Mutation, Support\Query, Support\Type, Support\UnionType #357cdn.jsdelivr.net and cdnjs.cloudflare.comValidatorError: remove setter and make it a constructor arg, add getter and rely on contractsis_lumen with static class call \Rebing\GraphQL\Helpers::isLumen\Fluent dependency on \Rebing\GraphQL\Support\Type\Rebing\GraphQL\Support\Type::$instances\Rebing\GraphQL\Support\Type::$unionTypeNew makeenum command and dedicated EnumType, deprecating $enumObject=true in the Type class
Welcome to the second Release Candidate for the v2 release line!
There have been 89 commits and changes in 95 files since the last RC (woha!).
There were some fixes not part of any changelog because technically these bugs were never publicly released and only existed between the v1 release and now; they're mostly related to the newly types added which were too restrictive or wrong at times.
Silently the test suite has been increased to cover parts which never had any tests, like for example file uploads.
make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367App\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjusted\Fluent dependency on \Rebing\GraphQL\Support\TypePlease report and issues you find or hop on slack and give us feedback!
This covers the changes since the last stable release of the v1 release line, v1.24.0
resolve($root, $array, SelectFields $selectFields, ResolveInfo $info)resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)make:graphql:input commandmake:graphql:union commandmake:graphql:interface commandmake:graphql:field commandmake:graphql:enum command and dedicated EnumType, deprecating $enumObject=true in the Type classmake:graphql:scalar command and add more information regarding scalars to the readmeTypeConvertible interface requiring to implement toType(): \GraphQL\Type\Definition\Type
Existing types are not affected because they already made use of the same method/signature, but custom Scalar GraphQL types work differently and benefit from the interfacealias is now also supported for relationships #367InputType support class which eventually replace $inputObject=true #363DB::raw() in alias fieldsApp\GraphQL\Queries, not App\GraphQL\Query anymore); make commands have been adjustedSupport\Field, Support\InterfaceType, Support\Mutation, Support\Query, Support\Type, Support\UnionType #357cdn.jsdelivr.net and cdnjs.cloudflare.comValidatorError: remove setter and make it a constructor arg, add getter and rely on contractsis_lumen with static class call \Rebing\GraphQL\Helpers::isLumen\Fluent dependency on \Rebing\GraphQL\Support\Type\Rebing\GraphQL\Support\Type::$instances\Rebing\GraphQL\Support\Type::$unionTypePrefix named GraphiQL routes with graphql. for compatibility with Folklore \#360
graphql. for compatibility with Folklore #360New config options headers to send custom HTTP headers and json_encoding_options for encoding the JSON response \#293
Auto-resolve aliased fields \#283
\o/Replace deprecated global array_* and str_* helpers with direct Arr::* and Str::* calls
array_* and str_* helpers with direct Arr::* and Str::* callsFixed infinite recursion for InputTypeObject self reference \#230
- Laravel 5.8 support
Don't report certain GraphQL Errors
- Mutation routes fix
Should fix the issue referenced here: https://github.com/rebing/graphql-laravel/issues/158
Should fix the issue referenced here: https://github.com/rebing/graphql-laravel/issues/158
- Fixed default error handler
Bump webonxy/graphql-php version requirement
handle_errors- Fixed validation
Can now add custom validation error messages to Queries and Mutations
Can now add custom validation error messages to Queries and Mutations
More details here https://github.com/webonyx/graphql-php#security
More details here https://github.com/webonyx/graphql-php#security
Also added support for InputObjectType rules validation.
Added support for Unions (https://github.com/rebing/graphql-laravel/blob/master/docs/advanced.md#unions) and Interfaces
Added support for Unions (https://github.com/rebing/graphql-laravel/blob/master/docs/advanced.md#unions) and Interfaces (https://github.com/rebing/graphql-laravel/blob/master/docs/advanced.md#interfaces)
Added rules support for Query fields
Added rules support for Query fields
An alias can be set to a field that corresponds to its database column.
An alias can be set to a field that corresponds to its database column.
Supports creating the schema, but the underlying PHP functionality does not do anything.
Supports creating the schema, but the underlying PHP functionality does not do anything.
Updating route and controller to give us the ability to create multilevel URI names \#69
- Composer fix
- SelectFields fix
- GET routes
- Enum types
- Privacy validation optimized
Nothing published for this version
One column per quarter.