johnatas-x/grumphp-mago

Execute Mago in a GrumPHP task.

2.20.2 2026-05-03 09:42 UTC

Requires

• carthage-software/mago: 1.25.2
• phpro/grumphp: 2.20.0

proprietary

• Johnatas

README

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

1. Add the extension in your grumphp.yml file:

extensions:
  - GrumphpMago\ExtensionLoader

1. 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.