creatuity / magento2-interceptors
Creatuity Compiled Interceptors Module
Installs: 39 875
Dependents: 1
Suggesters: 0
Security: 0
Stars: 115
Watchers: 21
Forks: 17
Open Issues: 3
This package is auto-updated.
Last update: 2024-11-13 14:51:18 UTC
README
ABOUT
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.
VERSIONS
As Magento 2.4 introduced changes in Interceptors generator which are not backward compatible this module has separate branch for both Magento versions:
- use 1.3.* for Magento 2.4 (branch: master)
- use 1.2.* for Magento 2.3 (branch: magento23)
CONFIGURATION
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
.
However 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.
TECHNICAL DETAILS
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) {
switch(getCurrentScope()){
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':
// ...
default:
return parent::methodX($arg);
}
}
PROS
-
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
- If you ever stumbled upon
-
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.
- No redundant calls to
-
Implemented as a module and can be easily reverted to the default
Generator\Interceptor
CONS
- Each time after making change in etc plugins config,
generated/code/*
andvar/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.