edmondscommerce/phpqa

Simple PHP QA pipeline and scripts. Largely just a collection of dependencies with configuration and scripts to run them together

Thursday, July 26, 2018
by edmondscommerce
Repository
1 Watchers
0 Stars
4,426 Installations

PHP
7 Dependents
0 Suggesters
0 Forks
8 Open issues
27 Versions
67 % Grown

The README.md

PHPQA

By Edmonds Commerce

Version 4 Updates

Brings in PHPStan 0.12 which is great, _(*1)

However you will need to do the following:, _(*2)

Remove PHPStan symlinks before upgrading

rm -f bin/phpstan*

Ensuring Correct PHPStan Configs

If you are overriding phpstan.neon in your qaConfig folder, then you need to make sure you have this in there:, _(*3)

parameters:
    level: max
    inferPrivatePropertyTypeFromConstructor: true

Version 3 Updates

You should update your phpunit.xml file to use printerClass="\PHPUnit\Util\TestDox\CliTestDoxPrinter", _(*4)

see ./phpunit.xml, _(*5)

Introduction

PHPQA is a quality assurance pipeline written in BASH that can be run both on the desktop as part of your development process and then also as part of a continuous integration (CI) pipeline., _(*6)

It runs tools in a logical order and will fail as quickly as possible., _(*7)

PHPQA has only been tested on Linux., _(*8)

, _(*9)

Installing

You can follow dev-master which should generally be pretty stable (all features are developed in feature branches and must pass CI before making it into master. Alternatively if you want real stability, you can track a release version of your choice., _(*10)

composer require edmondscommerce/phpqa:dev-master@dev --dev

Your project's composer.json needs to specify a bin folder. If it's not already present, add this:, _(*11)

    ...
    "config": {
        "bin-dir": "bin"
    }
    ...

Running

To run the full pipline, simply execute in your BASH terminal:, _(*12)

./bin/qa

Usage:

$ ./bin/qa -h

Usage:
bin/qa [-t tool to run ] [ -p path to scan ]

Defaults to using all tools and scanning whole project based on platform

 - use -h to see this help

 - use -p to specify a specific path to scan

 - use -t to specify a single tool:
     psr|psr4         psr4 validation
     com|composer     composer validation
     st|stricttypes   strict types validation
     lint|phplint     phplint
     stan|phpstan     phpstan
     unit|phpunit     phpunit
     infect|infection infection
     md|messdetector  php mess detector
     ma|markdown      markdown validation
     bf|phpbf         php beautifier and fixer
     cs|phpcs         php code sniffer
     l|loc            lines of code and other stats

By default, PHPQA will run against the entire project root., _(*13)

Single Tool:

If you want to run a single tool, use the -t option. See the usage above to get the shortcuts for the tools, _(*14)

./bin/qa -t stan

Specified Path:

Some of the tools allow us to restrict the scan to a specified path. To specify the path, use the -p option., _(*15)

./bin/qa -p ./src/specified/path.php

Combined

You can combine both options, _(*16)

./bin/qa -t stan -p ./src/specified/path.php

Configuration

Please see the Configuration docs, _(*17)

The Pipeline

Please see the Pipeline docs, _(*18)

The QA Tools

For full details and configuration instructions for all fo the tools, please see the PHPQA Tools, _(*19)

Platform Detection

PHPQA comes with a set of generic tools and configs, but also has some inbuilt profiles., _(*20)

Information on how this works can be found on the platform detection page, _(*21)

Specific platforms' docs are at:, _(*22)

Using for Continuous Integration (CI)

Please see the CI docs, _(*23)

Git Hooks

Have a look in gitHooks for git hooks that can be used in your project, _(*24)

The suggested way to use these is to symlink. Note that your actual git hook should not include the .bash file extension, _(*25)

To use the pre-commit hook, for example, you would do:, _(*26)

#cd to project root
cd /var/www/project/root

#cd to hooks folder
cd .git/hooks/

#create relative symlink
ln -s ../../vendor/edmondscommerce/phpqa/gitHooks/pre-commit.bash pre-commit

Then ensure the hook is executable by running it:, _(*27)

``` bash, _(*28)

cd to project root

cd /var/www/project/root, _(*29)

./git/hooks/pre-commit, _(*30)


And you should then see

===========================================, _(*31)

PHPQA Pre Commit Hook

```, _(*32)

The Versions

26/07 2018

dev-PHPQACodingStandard

Simple PHP QA pipeline and scripts. Largely just a collection of dependencies with configuration and scripts to run them together

project phpqa

Simple PHP QA pipeline and scripts. Largely just a collection of dependencies with configuration and scripts to run them together

edmondscommerce/phpqa

The README.md

PHPQA

By Edmonds Commerce

Version 4 Updates

Remove PHPStan symlinks before upgrading

Ensuring Correct PHPStan Configs

Version 3 Updates

Introduction

Installing

Running

Usage:

Single Tool:

Specified Path:

Combined

Configuration

The Pipeline

The QA Tools

Platform Detection

Using for Continuous Integration (CI)

Git Hooks

cd to project root

PHPQA Pre Commit Hook

The Versions

dev-PHPQACodingStandard

The Requires

The Development Requires

dev-master

The Requires

The Development Requires

1.1.1

The Requires

The Development Requires

1.0.1

The Requires

The Development Requires

1.1.0

The Requires

The Development Requires

1.0.0

The Requires

The Development Requires

dev-TighteningUpPHPUnitConfigs

The Requires

The Development Requires

0.0.3

The Requires

The Development Requires

dev-BetterBashArrayEmptyHandling

The Requires

The Development Requires

dev-docsProofRead

The Requires

The Development Requires

dev-LaravelDocs

The Requires

The Development Requires

dev-MissingXModes

The Requires

The Development Requires

dev-AllowIdShortVar

The Requires

The Development Requires

dev-PhpunitRetryFailedShouldTimeOut

The Requires

The Development Requires

dev-ImprovingDocs

The Requires

The Development Requires

dev-PhpstanPhpunitDocs

The Requires

The Development Requires

dev-magento1

The Requires

The Development Requires

dev-magento2-docs

The Requires

The Development Requires