v2.0.0-RC5
Pre-release
Pre-release
The release cycle is noticeable slowing down, indicating that the next major release will be there soon!
- There's now an upgrade guide from v1 to v2.
- We tried to enable
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.
Changes since the last Release Candidate
Changed
- Types and Schemas are now only booted when the
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.) #427
Fixed
- The Paginator correctly inherits the types model so it can be used with
SelectFields
and still generates correct SQL queries #415
Removed
- Removed
\Fluent
dependency on\Rebing\GraphQL\Support\Field
#431
Please report and issues you find or hop on slack and give us feedback!
Full Changelog since the latest v1 release
This covers the changes since the last stable release of the v1 release line, v1.24.0
Breaking changes
- The
UploadType
now has to be added manually to thetypes
in your schema if you want to use it- The
::getInstance()
method is gone
- The
- The order and arguments/types for resolvers has changed:
- before:
resolve($root, $array, SelectFields $selectFields, ResolveInfo $info)
- after:
resolve($root, $array, $context, ResolveInfo $info, Closure $getSelectFields)
- before:
- Added PHP types / phpdoc to all methods / properties #331
- Changes in method signatures will require small adaptions.
- Validation errors are moved from error.validation to error.extensions.validation as per GraphQL spec recommendation #294
- SelectFields on interface types now only selects specific fields instead of all #294
- Although this could be consider a bug fix, it changes what columns are selected and if your code as a side-effect dependent on all columns being selected, it will break
Added
- Added support for lazy loading types (config
lazyload_types
), improve performance on large type systems #405 but doens't work together with type aliases orpaginate()
. - A migration guide for the Folklore library as part of the readme
- New
make:graphql:input
command - New
make:graphql:union
command - New
make:graphql:interface
command - New
make:graphql:field
command - New
make:graphql:enum
command and dedicatedEnumType
, deprecating$enumObject=true
in theType
class - New
make:graphql:scalar
command and add more information regarding scalars to the readme TypeConvertible
interface requiring to implementtoType(): \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
#363- Support
DB::raw()
inalias
fields - GraphiQL: use regenerated CSRF from server if present #332
- Internal
- Added declare(strict_types=1) directive to all files
- Test suite has been refactored and now features Database (SQLite) tests too
Changed
- Types and Schemas are now only booted when the
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.) #427 - Follow Laravel convention and use plural for namspaces (e.g. new queries are placed in
App\GraphQL\Queries
, notApp\GraphQL\Query
anymore); make commands have been adjusted - Made the following classes abstract:
Support\Field
,Support\InterfaceType
,Support\Mutation
,Support\Query
,Support\Type
,Support\UnionType
#357 - Updated GraphiQL to 0.13.0 #335
- If you're using CSP, be sure to allow
cdn.jsdelivr.net
andcdnjs.cloudflare.com
- If you're using CSP, be sure to allow
ValidatorError
: remove setter and make it a constructor arg, add getter and rely on contracts- Replace global helper
is_lumen
with static class call\Rebing\GraphQL\Helpers::isLumen
Fixed
- The Paginator correctly inherits the types model so it can be used with
SelectFields
and still generates correct SQL queries #415 - Arguments are now validated before they're passed to
authorize()
#413 - File uploads now correctly work with batched requests #397
- Path multi-level support for Schemas works again #358
- SelectFields correctly passes field arguments to the custom query #327
- This also applies to privacy checks on fields, the callback now receives the field arguments too
- Previously the initial query arguments would be used everywhere