Coding standards & style guide - php-tuf/composer-stager GitHub Wiki

Coding standards

Composer Stager uses PHP_CodeSniffer (PHPCS) (phpcs.xml.dist) to automatically enforce as many coding standards as possible.

See also Automated testing.

Style guide

Other standards cannot realistically be enforced by automated tools because they involve human judgment:

  • Docblock annotation descriptions, e.g., @parameter and @return, should be the same wherever they appear with the same meaning. For example, @param int $timeout should have the same description on every function that takes it.
  • Exception messages should not end with a period (.).