Cli error handling for console/command-line PHP applications.



Collision logo
Collision code example

Build Status Quality Score Total Downloads Latest Stable Version License

Collision was created by, and is maintained by Nuno Maduro, and is a package designed to give you beautiful error reporting when interacting with your app through the command line.

  • It's included on Laravel, the most popular free, open-source PHP framework in the world.
  • Built on top of the Whoops error handler.
  • Supports Laravel, Symfony, PHPUnit, and many other frameworks.

Installation & Usage

Requires PHP 8.0+

Require Collision using Composer:

composer require nunomaduro/collision --dev

Laravel Version Compatibility

Laravel Collision
6.x 3.x
7.x 4.x
8.x 5.x
9.x 6.x

As an example, here is how to require Collision on Laravel 6.x:

composer require nunomaduro/collision:^3.0 --dev

Phpunit adapter

Phpunit must be 9.0 or higher.

Add the Collision printerClass to your phpunit.xml in the phpunit section:


No adapter

You need to register the handler in your code:

(new \NunoMaduro\Collision\Provider)->register();


Thank you for considering to contribute to Collision. All the contribution guidelines are mentioned here.

You can have a look at the CHANGELOG for constant updates & detailed information about the changes. You can also follow the twitter account for latest announcements or just come say hi!: @enunomaduro


Collision is an open-sourced software licensed under the MIT license.

Logo by Caneco.