Skip to content
New interceptors approach for Magento 2
Branch: master
Clone or download
Latest commit 5cb10e1 Jun 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
Generator default scope fix and further optimisation Jun 12, 2019
Test default case tests fix Jun 12, 2019
etc bugfix Jun 6, 2019
composer.json initial commit May 10, 2019
registration.php initial commit May 10, 2019


This component changes the way Magento 2 generates Interceptor classes (a mechanism that allows plugins to work together).

Instead of generating boilerplate code it compiles the Interceptor using information from source code. This makes plugins slightly faster and as Magento uses a lot of plugins, even at its core, it lowers request time by ~10%. This is important in places where there is a lot of non-cached PHP logic going on (for example admin panel is noticeably faster).

The default method uses code that is called on nearly each method to see if there are any plugins connected, in generated code this is not required and call-stack is reduced.

Having plugins called directly also makes code easier to debug and bugs easier to find.

The Interceptors generated by this plugin are 100% compatible with the ones generated by Magento by default, so there is no need to change anything in your plugins.


This module adds following preference to work in developer mode:

<preference for="Magento\Framework\Interception\Code\Generator\Interceptor" type="Creatuity\Interception\Generator\CompiledInterceptor" />

And following preferences to work in production or default modes:

<preference for="Magento\Setup\Module\Di\Code\Generator\Interceptor" type="Creatuity\Interception\Generator\CompiledInterceptor" />
<preference for="Magento\Setup\Module\Di\Compiler\Config\Chain\InterceptorSubstitution" type="Creatuity\Interception\Generator\CompiledInterceptorSubstitution" />

Those are enabled by default in module di.xml.

Hovewer this module does not touch the default generation method so you can override above preferences to fallback to the default mechanism for all or selected modes.


Instead of interceptors that read plugins config at runtime like this:

public function methodX($arg) {
    $pluginInfo = $this->pluginList->getNext($this->subjectType, 'methodX');
    if (!$pluginInfo) {
        return parent::methodX($arg);
    } else {
        return $this->___callPlugins('methodX', func_get_args(), $pluginInfo);

This generator generates static interceptors like this:

public function methodX($arg) {
        case 'frontend':
            $this->_get_example_plugin()->beforeMethodX($this, $arg);
            $this->_get_another_plugin()->beforeMethodX($this, $arg);
            $result = $this->_get_around_plugin()->aroundMethodX($this, function($arg){
                return parent::methodX($arg);
            return $this->_get_after_plugin()->afterMethodX($this, $result);
        case 'adminhtml':
            // ...
            return parent::methodX($arg);


  • Easier debugging.

    • If you ever stumbled upon ___callPlugins when debugging you should know how painful it is to debug issues inside plugins.
    • Generated code is decorated with PHPDoc for easier debugging in IDE
  • Fastest response time (5%-15% faster in developer and production mode)

    • No redundant calls to ___callPlugins in call stack.
    • Methods with no plugins are not overridden in parent at all.
  • Implemented as a module and can be easily reverted to the default Generator\Interceptor


  • Each time after making change in etc plugins config, generated/code/* and var/cache/* needs to be purged
  • As this does not load plugins at runtime, might not work in an edge case of plugging into core Magento classes like PluginsList etc.
You can’t perform that action at this time.