johnatas-x / grumphp-mago
Execute Mago in a GrumPHP task.
2.20.3
2026-05-07 06:45 UTC
Requires
- carthage-software/mago: 1.26.0
- phpro/grumphp: 2.20.0
README
Important
This extension is temporary.
It allows using Mago with GrumPHP in a simple (though somewhat unconventional) way while waiting for the merge of this PR into a release.
Once that happens, this extension will become outdated.
Description
This repository adds a task for GrumPHP that launches mago. During a commit check for PHP improvements. If a tool fails, it won't pass.
Installation
Install it using composer:
composer require --dev johnatas-x/grumphp-mago
Usage
- Add the extension in your grumphp.yml file:
extensions: - GrumphpMago\ExtensionLoader
- Add mago to the tasks (the example below shows default values):
tasks:
mago:
formatter: true
formatter_options: ['--staged']
linter: true
linter_options: ['--staged']
analyzer: true
analyzer_options: ['--staged']
guard: false
guard_options: []
- formatter (bool): Enable the formatter tool.
- formatter_options (array): List of options to pass to the formatter tool.
- linter (bool): Enable the linter tool.
- linter_options (array): List of options to pass to the linter tool.
- analyzer (bool): Enable the analyzer tool.
- analyzer_options (array): List of options to pass to the analyzer tool.
- guard (bool): Enable the architectural guard tool.
- guard_options (array): List of options to pass to the architectural guard tool.
Caution
You must have the mago configuration file in your project.
The paths must be defined in the configuration file.