Magento 2 GraphQL Introspection Cache

This module allows you to use the same mechanism that is used for caching regular GraphQL resolvers, for introspection queries.

This helps minimize the number of times Magento is bootstrapped.

The following introspection types are supported out of the box:

• ProductAttributeFilterInput

This module is experimental, it contains BC-fixes for older Magento versions (<2.4.2). Class internals will likely change when support for those versions end.

Getting Started

This module is intended to be installed with composer. From the root of your Magento 2 project:

1. Download the package

composer require graycore/magento2-graphql-introspection-cache

1. Enable the package

./bin/magento module:enable Graycore_GraphQlIntrospectionCache

Usage

You can add your own introspection cache identity by adding a bit of di.xml:

<type name="Graycore\GraphQlIntrospectionCache\Plugin\CachePlugin">
    <arguments>
        <argument xsi:type="array" name="introspectionHandlers">
            <item xsi:type="object" name="NameOfInspectedType">Namespace\Module\Model\Cache\Identity\Introspection\NameOfInspectedType</item>
        </argument>
    </arguments>
</type>

Your class must implement Magento\Framework\GraphQl\Query\Resolver\IdentityInterface.

For more information on GraphQL Cache Identities, please visit the official documentation.

Internals

• A before plugin is created on QueryProcessor::process to set a custom ReferenceExecutor. This ReferenceExecutor is instantiated using the Object Manager, so that we can use plugins on it in a later stage.
• An after plugin is created on ReferenceExecutor::doExecute. This plugin determines if we are dealing with an introspection request and if there is a cache identity registered for it. If there is, it will attempt to generate cache tags and add it to the request.

Check out the unit/integration tests to get a better picture.

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

0.2.2 (2026-05-18)

Miscellaneous Chores

• deps-dev: upgrade to phpunit/phpunit:^12 and magento/magento-coding-standard:^40 (8534f44)
• deps: bump graycoreio/github-actions-magento2 from @main to 8.2.0 (31a98bb)

0.2.1 (2026-03-04)

Miscellaneous Chores

• remove nodejs deps (35fb2ec)

0.2.0 (2025-02-26)

⚠ BREAKING CHANGES

• We no longer support php 7.4 as it is end of life.

Features

• compat with GraphQL\Executor\ReferenceExecutor from webonyx/graphql-php:15.18.1 (b553e47)
• drop support for php 7.4 (ff3e180)

Bug Fixes

• 8.2 deprecation of constructor existence check (db26ebb)
• add check for Executor::getDefaultArgsMapper for older versions (d460fca)
• backwards compat with webonyx 14.11.0 for v2.4.5-p11 and v2.4.4-p12 (1484b89)

Miscellaneous Chores

• add dealerdirect/phpcodesniffer-composer-installer allowed plugin (50b990a)

0.1.2 (2022-08-25)

Bug Fixes

• ensure reference executor always returns a new object (#6) (9daede3)

0.1.1 (2022-07-21)

Features

• add readme/license (#3) (f74262a)
• allow executor plugin to work with older webonyx graphql versions (#2) (1501383)