activecollab/baseline

Baseline for ActiveCollab project and components

3.1.1 2024-01-21 11:53 UTC

Requires

• php: >=8.0
• friendsofphp/php-cs-fixer: ^3.0
• phpunit/phpunit: >=7.0

MIT

README

Checking Code Quality

Checks

Checks are grouped into two groups:

1. Fixers - they check and modify the code. Modified files are automatically staged,
2. Analyzers - they check the code, perform analysis without changing the code.

Intnetion for this type of separation is to clearly communicate what user can expect from a particular check.

Running Checks Before each Commit

In order to add quality code checker as mandatory step prior to code being committed, you can use pre-commit hook. Open:

vi .git/hooks/pre-commit

and put:

#!/usr/bin/php
<?php

$qc_file_path = dirname(__DIR__, 2) . '/.php_qc.php';

if (is_file($qc_file_path)) {
    print "Quality checker found at {$qc_file_path}. Running checks...\n\n";

    try {
        $quality_checker = require_once $qc_file_path;
        $quality_checker->check();
    } catch (\Throwable $e) {
        $quality_checker->communicateFailure($e);
        
        exit(1);
    }
} else {
    print "Quality checker not found at {$qc_file_path}\n";
}

exit(0);

Don't forget to set pre-commit hook as executable:

chmod +x .git/hooks/pre-commit