danslo / magento2-module-private-parts
Allows you to create Magento 2 plugins for non-public methods.
Installs: 7
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 2
Forks: 1
Open Issues: 0
Type:magento2-module
Requires
- nikic/php-parser: ^4.10
This package is auto-updated.
Last update: 2024-10-21 02:07:59 UTC
README
PrivateParts is a Magento 2 module that lets you create plugins for protected and private methods.
Installation
$ composer require danslo/magento2-module-private-parts:dev-master
How it works
The class that is responsible for generating code for plugins is extended;
- Make it generate protected methods
- Make it generate private methods
- Any method that calls into a private method will have its method body inlined. The inlined code is only called if the private methods have at least 1 plugin. This is known at runtime, so we generate a list of private method and add
___isInlineCall
to the interceptor trait. - To make sure that the inlined code works as normal, we need to do several things:
- Any
use
statements in the original class need to be copied to the interceptor. - Property reads/writes are transformed into
___prop{Get|Set}
calls which use reflection to access original properties. - Private constants are inlined.
- Any
Currently known limitations (this list will likely grow in the future):
- More tests are required around plugin inheritance (private methods of parent classes).
- Generated code has incorrect indentation, planning to use nikic php-parser's
printFormatPreserving
. - Because we use a PHP Parser, code generation is a bit slower than normal. Runtime performance is mostly unaffected.
Disclaimer
You should probably not use this package.
It is not a secret that there are a lot of places in Magento that use private methods without properly applying composition, making extending core behavior difficult.
In those cases you are advised to make Magento extensible, either by dispatching events or by extracting logic into separate class. You should then submit a pull request and use composer-patches until your changes are merged upstream and released.
While public methods are not guaranteed to stay the same across releases (unless marked with @api), private methods are more prone to such changes.
This module was written as a fun side-project and exists purely as a proof of concept. Nothing in production is currently using this module. Use at your own risk.
License
Copyright 2020 Daniel Sloof
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.