Quality assurance toolchain
The Jasny PHP coding standard follows the PSR-2 coding standard with a few additions.
All PHP projects of Legal Things should include this package. It can be installed through composer.
composer require --dev jasny/php-code-quality
PHPUnit is a programmer-oriented testing framework for PHP. The unit tests should be in the
Copy the PHPUnit configuration into the projects root folder
cp vendor/jasny/php-code-quality/phpunit.xml.dist .
vfsStream is a stream wrapper for a virtual file system that may be helpful in unit tests to mock the real file system.
Codeception is a BDD style testing frameworks for PHP. It can be used for unit, functional and integration tests.
The Codeception module for Jasny MVC allows you to run tests for applications that use Jasny MVC.
Codeception isn't installed by default. It can be installed through composer.
composer require --dev codeception/codeception jasny/codeception-module
phpcloc Count the lines of codes in the project as PHP implementation of cloc.
phpcs tokenises PHP files and detects violations of a defined set of coding standards. It is an essential development tool that ensures your code remains clean and consistent.
This package comes with a custom ruleset which embodies the Jasny PHP coding standard, which should be copied to the project root folder.
cp vendor/jasny/php-code-quality/phpcs.xml.dist phpcs.xml
PHPStan is a static code analysis tool. It moves PHP closer to compiled languages in the sense that the correctness of each line of the code can be checked before you run the actual line.
Copy the PHPStan configuration to the project root folder
cp vendor/jasny/php-code-quality/phpstan.neon.dist phpstan.neon
Composer can be configured to run all tests
"phpcloc cloc src",
"phpcs -p src"
"test": "Run all tests and quality checks"
To run all tests do
composer run-script test
Open source projects should all of these quality assurance services. Closed source project may use a single service to both run tests and code quality checks in order to save costs.
Travis CI will run all unit tests on each pull-request and push to the master branch.
Copy the Travis CI configuration file from the php-code-quality directory.
cp vendor/jasny/php-code-quality/travis.yml.dist .travis.yml
Scrutinizer tests code quality using PHP CodeSniffer, PHPStan and a custom analysis tool from Scrutinizer. It also collects tests coverage results from Travis CI.