NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1209 most downloaded on Packagist
A composer plugin that enables source code quality checks.
Latest stable
v2.26.0
Last release 1 months ago
16 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
116 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Require gitlib 1.7 and fix its deprecations by @lyrixx in #1237
Full Changelog: https://github.com/phpro/grumphp/compare/v2.25.0...v2.26.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
GrumPHP passed repository files to external tools as plain arguments, so a file whose name starts with - could be read as an option, such as --config
GrumPHP passed repository files to external tools as plain arguments, so a file whose name starts with - could be read as an option, such as --config, instead of a path. Paths starting with - are now prefixed with ./, and the git_blacklist task matches file names literally. See GHSA-fmpp-rfr9-jgpg for details.
Thanks to @jf0x3a for reporting this responsibly.
Full Changelog: v2.24.0...v2.25.0
feat(phpmd): PHPMD report format allowed values matches renderers by @freezysko in #1229
Full Changelog: v2.23.0...v2.24.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.23.0...v2.24.0
Bump actions/cache from 5 to 6 by @dependabot[bot] in https://github.com/phpro/grumphp/pull/1226
Full Changelog: https://github.com/phpro/grumphp/compare/v2.22.0...v2.23.0
Full Changelog: v2.22.0...v2.23.0
GrumPHP just made a new friend. Starting this release, you can run Mago straight from your hooks.
GrumPHP just made a new friend. Starting this release, you can run Mago straight from your hooks.
Mago is a PHP toolchain written in Rust. The name means "wizard," which fits: it does the work of four tools at once. A formatter, a linter, a static analyzer, and an architectural guard, all in a single fast binary. It's already showing up in places like Drupal.
We didn't bolt it on as one big task. Each part gets its own, so you turn on only what you want and configure them separately:
mago_format keeps your code style consistentmago_lint catches style slips, smells, and likely bugsmago_analyze does the deeper work: types, control flow, logic errorsmago_guard enforces your architecture and layer rulesFormat, lint, and analyze run read-only by default. When one fails, GrumPHP offers to re-run it with fixes applied, so you stay in control. Guard only reports, because you can't auto-fix an architecture problem (Mago won't pretend otherwise).
Add it to your project like any other tool:
composer require --dev carthage-software/mago
vendor/bin/mago initThen point your grumphp.yml at whichever tasks you want. Full setup and options live in the Mago task docs.
The grump approves. Welcome to the family, Mago. 🧙🦊
amend! prefix in commit message task by @reynkonig in #1224Full Changelog: v2.21.0...v2.22.0
Bump actions/dependency-review-action from 4 to 5 by @dependabot [bot] in #1217
Full Changelog: v2.20.0...v2.21.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.20.0...v2.21.0
Cover more of Drupal's custom file extensions by @damienmckenna in #1203
Full Changelog: v2.19.0...v2.20.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.19.0...v2.20.0
Bump actions/cache from 4 to 5 by @dependabot [bot] in #1201
❗ Requires re-initialization from git hooks
In the new version of our dependency gitlib, you need to pass the --raw option to the git diff that is being parsed by the pre-commit hooks. This means you'll need to change your git hook after upgrading:
./vendor/bin/grumphp git:initIf you are using a custom hook, make sure to add the --raw parameter to git diff first:
DIFF=$(git -c diff.mnemonicprefix=false -c diff.noprefix=false --no-pager diff --raw -r -p -m -M --full-index --no-color --staged | cat)
Full Changelog: v2.18.0...v2.19.0
Fix installation link for deptrac by @codisart in #1190
Full Changelog: v2.17.0...v2.18.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.17.0...v2.18.0
Php 85 upgrade by @veewee in #1189
Full Changelog: https://github.com/phpro/grumphp/compare/v2.16.0...2.17.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.16.0...v2.17.0
Add composer_validate_autoload task by @TravisCarden in #1186
composer_validate_autoload task by @TravisCarden in #1186Full Changelog: v2.15.0...v2.16.0
composer_validate_autoload task by @TravisCarden in https://github.com/phpro/grumphp/pull/1186Full Changelog: https://github.com/phpro/grumphp/compare/v2.15.0...v2.16.0
Fix Security Checker Enlightn Allow List by @youwe-petervanderwal in #1180
Full Changelog: v2.14.0...v2.15.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.14.0...v2.15.0
Mark 1.x as unsupported in SECURITY.md by @marcwrobel in #1176
Full Changelog: v2.13.0...v2.14.0
Full Changelog: https://github.com/phpro/grumphp/compare/v2.13.0...v2.14.0
Fix typo in GrumPHPPlugin.php by @echernyavskiy in https://github.com/phpro/grumphp/pull/1169
Full Changelog: https://github.com/phpro/grumphp/compare/v2.12.0...v2.13.0
Ticket #1157: support specific filenames as trigger for Shell. by @evs-xsarus in https://github.com/phpro/grumphp/pull/1167
Full Changelog: https://github.com/phpro/grumphp/compare/v2.11.0...v2.12.0
Allow laravel/serializable-closure 2 by @simoheinonen in https://github.com/phpro/grumphp/pull/1165
Full Changelog: https://github.com/phpro/grumphp/compare/v2.10.0...v2.11.0
Adds 'skip_initial_tests' and 'coverage' options support to infection… by @jose-ba in https://github.com/phpro/grumphp/pull/1160
Full Changelog: https://github.com/phpro/grumphp/compare/v2.9.0...v2.10.0
Adds 'parallel' option support to phpcs task. by @mrmishmash in https://github.com/phpro/grumphp/pull/1155
Full Changelog: https://github.com/phpro/grumphp/compare/v2.8.0...v2.9.0
Cleanup serialized context coming back from a task worker by @veewee in https://github.com/phpro/grumphp/pull/1147
Full Changelog: https://github.com/phpro/grumphp/compare/v2.7.0...v2.8.0
Support --skip-property-types of ValidateSchemaCommand by @wucdbm in https://github.com/phpro/grumphp/pull/1145
Full Changelog: https://github.com/phpro/grumphp/compare/v2.6.0...v2.7.0
feat: Add task for Twig-CS-Fixer by @antoniovj1 in https://github.com/phpro/grumphp/pull/1131
Full Changelog: https://github.com/phpro/grumphp/compare/v2.5.0...v2.6.0
Bump actions/dependency-review-action from 3 to 4 by @dependabot in https://github.com/phpro/grumphp/pull/1120
Full Changelog: https://github.com/phpro/grumphp/compare/v2.4.0...v2.5.0
Make reproducable composer.lock available in repo by @veewee in https://github.com/phpro/grumphp/pull/1117
Full Changelog: https://github.com/phpro/grumphp/compare/v2.3.0...v2.4.0
Resolve env placeholders in configuration by @tkulka in https://github.com/phpro/grumphp/pull/1113
Full Changelog: https://github.com/phpro/grumphp/compare/v2.2.0...v2.3.0
Add grouping of output in GitHub Actions by @jackbentley in https://github.com/phpro/grumphp/pull/1074
Full Changelog: https://github.com/phpro/grumphp/compare/v2.1.0...v2.2.0
Add new nette tester options by @hanisko in https://github.com/phpro/grumphp/pull/1097
Full Changelog: https://github.com/phpro/grumphp/compare/v2.0.0...v2.1.0
Remove v1 deprecations by @veewee in https://github.com/phpro/grumphp/pull/1092
Full Changelog: https://github.com/phpro/grumphp/compare/v1.16.0...v2.0.0-beta1
❗ Change in dependencies - we now require:
If your project is still using AMP v2 - you might consider using our dependencyless shim package instead : https://github.com/phpro/grumphp-shim
❗ This version contains some BC breaks for GrumPHP extension or task developers.
Find out how to upgrade your tasks and extensions here : https://github.com/phpro/grumphp/blob/v2.0.0-beta1/UPGRADE-v2.md
Full Changelog: https://github.com/phpro/grumphp/compare/v1.16.0...v2.0.0
Remove v1 deprecations by @veewee in https://github.com/phpro/grumphp/pull/1092
Full Changelog: https://github.com/phpro/grumphp/compare/v1.16.0...v2.0.0-beta1
composer require 'phpro/grumphp:^2.0.0-beta1@beta' --update-with-dependencies
❗ Change in dependencies - we now require:
❗ This version contains some BC breaks for GrumPHP extension or task developers.
Find out how to upgrade your tasks and extensions here : https://github.com/phpro/grumphp/blob/v2.0.0-beta1/UPGRADE-v2.md
Fix workflow deprecations by @jackbentley in https://github.com/phpro/grumphp/pull/1077
Full Changelog: https://github.com/phpro/grumphp/compare/v1.15.0...v1.16.0
Add Rector Task by @alessandroaussems in https://github.com/phpro/grumphp/pull/1054
Full Changelog: https://github.com/phpro/grumphp/compare/v1.14.0...v1.15.0
Added deprecation to whitelist_patterns with null value by @mrbase in https://github.com/phpro/grumphp/pull/1049
Full Changelog: https://github.com/phpro/grumphp/compare/v1.13.0...v1.14.0
chore: Set permissions for GitHub actions by @naveensrinivasan in https://github.com/phpro/grumphp/pull/1009
Full Changelog: https://github.com/phpro/grumphp/compare/v1.12.0...v1.13.0
Add ignore_patterns to git_blacklist. by @verbruggenalex in https://github.com/phpro/grumphp/pull/1005
Full Changelog: https://github.com/phpro/grumphp/compare/v1.11.0...v1.12.0
Restore PHP 7.4 compatibility by @danepowell in https://github.com/phpro/grumphp/pull/994
show_mutations (incl. verbose mode) by @jerowork in https://github.com/phpro/grumphp/pull/998Full Changelog: https://github.com/phpro/grumphp/compare/v1.10.0...v1.11.0
Upgrade tools + SF6 Breaking changes by @veewee in https://github.com/phpro/grumphp/pull/996
Full Changelog: https://github.com/phpro/grumphp/compare/v1.9.0...v1.10.0
Incorrect global install for stylelint task by @jreklund in https://github.com/phpro/grumphp/pull/985
no-dev option for local-php-security-checker by @a-menshchikov in https://github.com/phpro/grumphp/pull/984Full Changelog: https://github.com/phpro/grumphp/compare/v1.8.1...v1.9.0
This release fixes grumphp-shim issues.
This release fixes grumphp-shim issues.
Full Changelog: https://github.com/phpro/grumphp/compare/v1.8.0...v1.8.1
PHP81 compatibility: Laravel closure by @veewee in https://github.com/phpro/grumphp/pull/983
Full Changelog: https://github.com/phpro/grumphp/compare/v1.7.1...v1.8.0
update doc typos by @aquilasys in https://github.com/phpro/grumphp/pull/977
Full Changelog: https://github.com/phpro/grumphp/compare/v1.7.0...v1.7.1
Update Psalm output formats by @weirdan in https://github.com/phpro/grumphp/pull/958
Full Changelog: https://github.com/phpro/grumphp/compare/v1.6.0...v1.7.0
Add Behat task support for Behat's "profile" command line argument by @dsiemensma-m4m in https://github.com/phpro/grumphp/pull/933
Full Changelog: https://github.com/phpro/grumphp/compare/v1.5.0...v1.6.0
Locked parallel-functions to a working version.
Locked parallel-functions to a working version.
Full Changelog: https://github.com/phpro/grumphp/compare/v1.5.0...v1.5.1
923: Allow ondram/ci-detector ^4.0 upgrade thanks to @fbnfgc
Total issues resolved: 3
904: Add Stylelint task thanks to @yguedidi
Total issues resolved: 6
https://github.com/phpro/grumphp-shim/pull/12: Fix PHP80 Stringable polyfill
Total issues resolves: 1
875: Fixed a typo in tasks.md thanks to @peternijssen
Total issues resolved: 10
842: Check config before skipping thanks to @dhaarbrink
Total issues resolved: 10
841: Implement refactored formatter options for Deptrac >= v0.9.0 thanks to @jerowork
Total issues resolved: 6
832: Call to undefined function get_debug_type() thanks to @prudloff-insite
Total issues resolved: 6
818: Improve no-ansi reporting thanks to @veewee
Total issues resolved: 12
This release contains exactly the same functionality as previous release, but with a backward compatibility promise!
This release contains exactly the same functionality as previous release, but with a backward compatibility promise!
812: [Task\ add Pest thanks to @oallain
Total issues resolved: 2
652: [ECS task\ Run pre commit argument switch thanks to @jmatthiesen81
Total issues resolved: 13
match_word option to git blacklist task thanks to @morloderexInside the ECS task, we renamed the whitlist_patterns option to paths:
grumphp:
tasks:
ecs:
- whitelist_patterns: ['src']
+ paths: ['src']
766: [phpmd\ Allow setting output format to ansi thanks to @MarkVaughn
Total issues resolved: 8
772: Fix for serialization of empty file list thanks to @veewee
Total issues resolved: 5
741: Improved task runner thanks to @veewee
Total issues resolved: 1
The new version will validate the structure and content of the GrumPHP parameters.
Therefor you need to move the grumphp parameters out of the regular parameters section.
If you are not using any symfony/dependency-injection parameters, you only need to rename the parameters keyword:
# grumphp.yaml
- parameters:
+ grumphp:
note: If you are using conventions, the parameters used in the conventions still need to remain under parameters. Don't forget to put tasks and other grumphp related configuraiton under grumphp!
note: The parameters bin_dir and git_dir have been removed since v0.16 . It is safe to get rid of those parameters as well. We now use an environment based system to customize paths.
grumphp:
- bin_dir: "./vendor/bin"
- git_dir: "."
Since PHP-CS-Fixer is out for quite some time and because v3 is in the making, we drop support for version 1. If you still want to use version 1, you can use an older version of GrumPHP or provide a custom extension for your project.
By default, the phpcsfixer will now load the task for the latest PHP-CS-fixer.
We also provided a phpcsfixer2 alias to make sure existing projects don't break.
However, you can now rename the task inside your configuration:
# grumphp.yaml
grumphp:
tasks:
- phpcsfixer2:
+ phpcsfixer:
We added a way of running the PHP-CS-Fixer v1 in parallel to improve execution speed. However, this code is not needed anymore inside the new version and might be confusing with the actual parallel implementation. Therefore, we removed following parameters:
# grumphp.yaml
grumphp:
- process_async_limit: 10
- process_async_wait: 1000
In this release, we bump the dependencies up to Symfony 4.4. This is because the parallel system requires the Advanced console output improvements inside SF 4.1. Since that version is not supported by Symfony anymore, we decided to bump to the version 4 LTS.
If your package still requires older dependencies, you can install the grumphp-shim package which works dependency-less.
686: twigcs exclude subfolders thanks to @oallain
Total issues resolved: 9
501: FR: remove need for dedicated class when running same task twice with different configuration thanks to @keradus
Total issues resolved: 9
getConfigurableOptions() staticgetConfigurableOptions() staticEmptyTaskConfig during constructiongetConfiguration() method by the getConfig() methodwithConfig() method.710: Fix composer process version in development integrator
Total issues resolved: 5
Grumphp-Shim Total issues resolved: 1
707: Remove Old Compatibility Layer for Pre-5.x Symfony Process
One column per quarter.