Download the PHP package magento/magento-coding-standard without Composer
On this page you can find all versions of the php package magento/magento-coding-standard. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download magento/magento-coding-standard
More information about magento/magento-coding-standard
Files in magento/magento-coding-standard
Package magento-coding-standard
Short Description A set of Magento specific PHP CodeSniffer rules.
License OSL-3.0 AFL-3.0
Informations about the package magento-coding-standard
Magento Coding Standard
A set of Magento rules for PHP_CodeSniffer tool.
Installation within a Magento 2 site
To use within your Magento 2 project you can use:
Due to security, when installed this way the Magento standard for phpcs cannot be added automatically.
You can achieve this by adding the following to your project's composer.json
:
Installation for development
You can install Magento Coding Standard by cloning this GitHub repo:
It is possible also to install a standalone application via Composer
Verify installation
Command should return the list of installed coding standards including Magento2.
Usage
Once installed, you can run phpcs
from the command-line to analyze your code MyAwesomeExtension
Fixing issues automatically
Also, you can run phpcbf
from the command-line to fix your code MyAwesomeExtension
for warnings like "PHPCBF CAN FIX THE [0-9]+ MARKED SNIFF VIOLATIONS AUTOMATICALLY"
Contribution
See the community contribution model.
Where to contribute
- Documentation of existing rules. See ExtDN PHP CodeSniffer rules for Magento 2 as a good example.
- Bug fixes and improvements of existing rules.
- Creation of new PHP CodeSniffer rules.
- Discussions on new rules (through periodic hangouts or discussions per GitHub issue).
How to contribute
1) Start with looking into Community Dashboard. Any ticket in Up for grabs
is a good candidate to start.
2) Didn't satisfy your requirements? Create one of three types of issues:
- Bug report - Found a bug in the code? Let us know!
- Existing rule enhancement - Know how to improve existing rules? Open an issue describe how to enhance Magento Coding Standard.
- New rule proposal - Know how to improve Magento ecosystem code quality? Do not hesitate to open a proposal.
3) The issue will appear in the
Backlog
column of the Community Dashboard. Once it will be discussed and getaccepted
label the issue will appear in theUp for grabs
column.
Testing
All rules should be covered by unit tests. Each Test.php
class should be accompanied by a Test.inc
file to allow for unit testing based upon the PHP_CodeSniffer parent class AbstractSniffUnitTest
.
You can verify your code by running
Also, verify that the sniffer code itself is written according to the Magento Coding Standard:
ESLint
Prerequisites: Node.js (^12.22.0
, ^14.17.0
, or >=16.0.0
).
You need to run the following command to install all the necessary packages described in the package.json
file:
You can execute ESLint as follows:
RECTOR PHP
From magento-coding-standard
project, you can execute rector php as follows:
The rules from rector that are applied are set inside the config file: rector.php
The option --dry-run
displays errors found, but code is not automatically fixed.
To run rector for magento
projects you need to:
- Specify the magento path and the autoload file for the magento project:
Example:
License
Each Magento source file included in this distribution is licensed under the OSL-3.0 license.
Please see LICENSE.txt for the full text of the Open Software License v. 3.0 (OSL-3.0).
All versions of magento-coding-standard with dependencies
webonyx/graphql-php Version ^15.0
ext-simplexml Version *
ext-dom Version *
squizlabs/php_codesniffer Version ^3.6.1
rector/rector Version ^1.2.4
phpcsstandards/phpcsutils Version ^1.0.5
magento/php-compatibility-fork Version ^0.1