Working with the Architecture
In addition to understanding fundamental programming designs/concepts, you are encouraged to learn how the MVC architecture works in our code and how to work with Magento’s generated code and factories.
Avoid modification of the Magento Core
The core code is the default Magento code that comes with the application. You should never edit the core code because code changes occur between version upgrades and any changes you make will get overwritten. Try achieving your desired behavior with plugins, overriding interface preferences, and event observers.
If you feel that Magento can be improved with your core code changes, please consider contributing via Git.
Learn the architecture
To create the optimum module, you should get to know the Magento 2 architecture. Start off by familiarizing yourself with the Admin Pattern Library, the core Magento Components, and our service contracts and APIs.
Check your extension configurations
Make sure your extension is configured correctly in each of your extension’s configuration files. Invalid or unexpected values will cause your extension to behave incorrectly within Magento.
Know and leverage the Magento 2 framework
There have been some significant changes from Magento 1. Be sure to study the capabilities and standards of the Magento 2 Framework.
- Instead of creating custom validators from scratch, implement the
- Instantiating a database connection can be expensive and unnecessary. Magento provides resource models for performing SQL commands. (See Persistence Layer)
- Consider using Magento framework conventions instead of low-level or PHP functionality.
- Use the
Magento\Framework\Data\Collectionclass to retrieve a collection of filtered objects instead of directly querying the database.
Use dependency injection
Direct class instantiation is not recommended because the class can be rewritten. If the class is created directly, any rewrites will not be applied and it breaks Magento’s class rewrite capability. We encourage you to become familiar with how we use dependency injection to get an instance of a class.
Follow Model-View-Control (MVC) pattern
Make sure your extension adheres to the MVC Pattern, and that it does not violate any of its principles.
Some important things to check in your extensions:
- Make sure your Business Logic, Configuration, and SQL are implemented in the correct places.
- Use appropriate logic in a Block, Helper, Template, Controller, or Model.
- Ensure correct module design.
Use the PHP_CodeSniffer tool
PHP_CodeSniffer is a set of PHP scripts that checks your code for violations of a particular coding standard. It can be used in conjunction with the Magento Coding Standard to check your code for some of the more common Magento and PHP problems. Using these two tools will ensure that your extension code meets many of Magento’s coding standards. It also has the added benefits of keeping your code clean and maintainable.