A very opinionated CS/linting setup for PHP projects.
To add the coding standards checkers and linters to your PHP project, follow the instructions below:
- Make sure you don't have any uncommited files in your project.
This package will add files to your project, so you'll likely want to commit all of these all at once.
- Add the package to your project with Composer using the command below:
composer require --dev eckinox/eckinox-csThe package will automatically add all of the configuration files and utility scripts you'll need to your project.
- Follow any additional instructions provided in the CLI.
- Commit the files to your project:
git add --a && git commit -m "Adds coding standards and linting checks via eckinox/eckinox-cs"
This package is a like a metapackage, but with a little sugar on top.
Not only does it add other PHP dependencies via Composer, but it also:
- Adds JS dependencies.
- Creates configuration files.
- Adds shell scripts to facilitate usage of the tools.
- Adds a Git pre-commit hook.
- Adds a Github actions workflow.
Here's a bit of information about all of that.
Here are the tools that are included and configured in this package:
A tool to automatically fix PHP Coding Standards issues
PHP Static Analysis Tool - discover bugs in your code without running it!
PHP Mess Detector
The missing checkstyle for twig!
A mighty, modern linter that helps you avoid errors and enforce conventions in your styles.
The Git-aware column indicates tools whose provided execution script (located in
DEV/cs/) will only take into account staged files, instead of running on every file in your project every time.
The packge creates configuration files for every tool it adds.
These configuration files match Eckinox's coding standards, and should not be changed manually.
Changed files could be overwritten in later updates of
The package includes a pre-commit script that will execute all of the provided tools to check for potential errors and non-standard code.
If you don't have a pre-commit script already, the package will automatically set up this one (as a symbolic link) when you install the package.
If you already have a pre-commit, you will have to merge the two manually.
To ensure your project is always respecting the standards, this package adds a workflow for Github Actions that runs every included tool on your codebase.
This allows project members and maintainers to view the status of every branch and pull request, right in Github.