Development toolkit for CodeIgniter libraries and projects
- Install via Composer:
> composer require --dev codeigniter4/devkit
These are integrated into the workflows but not included via Composer. If you want to use them locally they will need to be installed. All of them (except Rector) are available via Phive.
The provided source files should be considered guidelines or templates for your own use, as they may need changing to fit your environment. These are based on the following assumptions:
- Your default repository branch is set to
develop - You use Composer to manage all necessary dependencies
- Your source code is located in app/ (for projects) or src/ (for libraries)
- Your unit tests are located in tests/
- Your CodeIgniter dependency is
codeigniter4/framework(some paths need to be changed fordev-develop)
This kit includes a number of workflow templates for integrating GitHub Actions into your library or project development process. To add these to your repo simply copy the workflows into a .github/workflows/ directory.
Hint: the source files also include a configuration for Dependabot which will help keep your dependencies and workflows updated.
Below is a brief description of each workflow; see the links above for help with each tool.
Requires depfile.yaml
Deptrac is a "dependency tracing" tool that allows developers to define which components should
be allowed to access each other. This helps keep your project architecture logical and concise
by enforcing the rules you set. For example, you may want to impose an MVC-style architecture
by allowing a Controller to use any Model but not vice-versa.
Requires infection.json.dist
Just because your tests reach a high level of code coverage does not mean they are comprehensive. Mutation Testing is a way of gauging the quality of your unit tests. A silly example: your code has an increment function with a single unit test for 100% coverage:
function increment(int $num1, int $num2): int
{
return $num1 + $num2;
}
function testIncrementWithZero()
{
$result = increment(42, 0);
$this->assertSame(42, $result);
}Infection will re-run your unit test against "mutated" versions of your code that should
cause failures and report "escaped mutations" when they still pass. In this example, Infection
mutates your increment() function to use - instead of +, but since your test case
still asserts 42 as the result it is considered an "escape" and you should plan to add
more tests.
PHP Copy-Paste Detector analyzes your code and reports when there are blocks of duplicate code more than a certain number of lines long (default: 5). In most cases this is a sign of poor code structure and an opportunity to consolidate classes or functions.
PHP CS Fixer is used to enforce coding standards. Once the rules are defined in the config file the workflow will check your code against the definitions and fail for any deviance.
Requires phpstan.neon.dist
Static analysis is a major factor in catching bugs and issues before they happen. PHPStan will analyze your code for mistakes based on the configuration supplied.
Requires phpunit.xml.dist
Unit testing automates running your code through all the possible scenarios before putting it into use in production. PHPUnit is a highly-configurable framework and suite for writing and running unit tests. This workflow also configures PHPUnit to report on code coverage and upload the results to Coveralls.io (you will need a free account, but it is also fine to use this workflow without Coveralls).
Requires rector.php
Rector provides automated refactoring of code, allowing you to make sweeping updates based on predefined rulesets. Rector can be highly opinionated based on its configuration file (rector.php) so be sure to read the documentation and figure out the best fit for you. This workflow performs a "dry run" to check for any changes that Rector would have made and fail if there are matches.
Note: Rector updates rules all the time so you may want to lock your repo to the latest known working version of Rector to prevent unexpected failures E.g. in .github/workflows/rector.yml supply the specific minor patch:
composer global require --dev rector/rector:0.12.4
Composer Unused does one thing: checks that your code actually uses the dependencies you have included via Composer. It can be easy to forget to update your composer.json when your code drops a dependency, so this workflow will help track those down.