Difference between revisions of "Coding Standards"

From Freephile Wiki
Jump to navigation Jump to search
m (Text replacement - "<abbr title="[^"]+">(.*)<\/abbr>" to "$1")
Line 9: Line 9:
 
* [https://github.com/squizlabs/PHP_CodeSniffer/wiki/Usage Usage]
 
* [https://github.com/squizlabs/PHP_CodeSniffer/wiki/Usage Usage]
 
* There is a [https://packagist.org/packages/mediawiki/mediawiki-codesniffer sniff file for MediaWiki] (see [https://github.com/wikimedia/mediawiki-tools-codesniffer here]) that you can use to conform to [[mw:Manual:Coding_conventions|MediaWiki Coding Conventions]]
 
* There is a [https://packagist.org/packages/mediawiki/mediawiki-codesniffer sniff file for MediaWiki] (see [https://github.com/wikimedia/mediawiki-tools-codesniffer here]) that you can use to conform to [[mw:Manual:Coding_conventions|MediaWiki Coding Conventions]]
 +
 +
 +
For users of Atom, the [https://atom.io/packages/docblockr docblockr] package makes it easy to write your Doxygen comments. Just press <kbd>tab</kbd> or <kbd>enter</kbd> after you begin typing a comment.
  
 
[[Category:Tools]]
 
[[Category:Tools]]

Revision as of 13:59, 8 August 2018

In the PHP community, as well as every other development community, there has been a long-standing tradition of establishing 'Coding Standards' that specify how developers should format their code. So, the PHP Framework Interop(ability) Group came up with PSR-1 and PSR-2 that deal with the issue specifically.

Tools[edit | edit source]

Fabien Potencier (Sensio Labs) has released the PHP Coding Standards Fixer tool which fixes most issues in your code. It helps you follow the PHP coding standards as defined in the PSR-1 and PSR-2 documents.

Greg Sherwood (Squiz Labs) is the maintainer of PHP CodeSniffer, which was originally a PEAR project. PHP_CodeSniffer is a PHP5 script that tokenises and "sniffs" PHP, JavaScript and CSS files to detect violations of a defined coding standard. It is an essential development tool that ensures your code remains clean and consistent. It can also help prevent some common semantic errors made by developers.


For users of Atom, the docblockr package makes it easy to write your Doxygen comments. Just press tab or enter after you begin typing a comment.