PHPackages                             nunomaduro/collision - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. nunomaduro/collision

ActiveLibrary[CLI &amp; Console](/categories/cli)

nunomaduro/collision
====================

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

v8.9.1(3mo ago)4.6k331.8M—0.7%177[29 issues](https://github.com/nunomaduro/collision/issues)[5 PRs](https://github.com/nunomaduro/collision/pulls)20MITPHPPHP ^8.2.0CI passing

Since Oct 8Pushed 5d ago30 watchersCompare

[ Source](https://github.com/nunomaduro/collision)[ Packagist](https://packagist.org/packages/nunomaduro/collision)[ Fund](https://www.paypal.com/paypalme/enunomaduro)[ GitHub Sponsors](https://github.com/nunomaduro)[ RSS](/packages/nunomaduro-collision/feed)WikiDiscussions v8.x Synced 1mo ago

READMEChangelogDependencies (10)Versions (122)Used By (20)

 [![Collision logo](https://raw.githubusercontent.com/nunomaduro/collision/v7.x/docs/logo.png)](https://raw.githubusercontent.com/nunomaduro/collision/v7.x/docs/logo.png)
 [![Collision code example](https://raw.githubusercontent.com/nunomaduro/collision/v7.x/docs/example.png)](https://raw.githubusercontent.com/nunomaduro/collision/v7.x/docs/example.png)

 [![Build Status](https://camo.githubusercontent.com/d3b7a273a2a93aecd7c7914225c0d82cf7da93ba2e13fa7d41d3f16f007aec59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e756e6f6d616475726f2f636f6c6c6973696f6e2f74657374732e796d6c3f6272616e63683d76382e78266c6162656c3d7465737473267374796c653d726f756e642d737175617265)](https://github.com/nunomaduro/collision/actions) [![Quality Score](https://camo.githubusercontent.com/e8cd023064862e6e43ebc668abbdb9fdf2c1111d68d46514cf8b26c958c49eca/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6e756e6f6d616475726f2f636f6c6c6973696f6e2e737667)](https://scrutinizer-ci.com/g/nunomaduro/collision) [![Total Downloads](https://camo.githubusercontent.com/bbcb3d075137cf730ad63aa9385a868c9037d924536fd7ef8b2be856bfd7d08f/68747470733a2f2f706f7365722e707567782e6f72672f6e756e6f6d616475726f2f636f6c6c6973696f6e2f642f746f74616c2e737667)](https://packagist.org/packages/nunomaduro/collision) [![License](https://camo.githubusercontent.com/b2527b89a36e4d2225b4ca6963dce2fa5ac988756c6673a41c0bd3b4c59f143c/68747470733a2f2f706f7365722e707567782e6f72672f6e756e6f6d616475726f2f636f6c6c6973696f6e2f6c6963656e73652e737667)](https://packagist.org/packages/nunomaduro/collision) [![Why PHP in 2026](https://camo.githubusercontent.com/d2b9305e630caf7daae4ca023de39ece0b885c37461629d42961533f00868b76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5768795f5048502d696e5f323032362d3741383645383f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d313831383162)](https://whyphp.dev) [![YouTube Channel Subscribers](https://camo.githubusercontent.com/a32a48cc6ec1283f38f5beedd4f3aec3eff914f663007ce9295ab1b60e5507e2/68747470733a2f2f696d672e736869656c64732e696f2f796f75747562652f6368616e6e656c2f73756273637269626572732f55434f5f68595a463267625f4379473573413741726c47673f7374796c653d666c6174266c6162656c3d796f757475626526636f6c6f723d627269676874677265656e)](https://youtube.com/@nunomaduro?sub_confirmation=1)

---

Collision was created by, and is maintained by **[Nuno Maduro](https://github.com/nunomaduro)**, 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](https://laravel.com)**, the most popular free, open-source PHP framework in the world.
- Built on top of the **[Whoops](https://github.com/filp/whoops)** error handler.
- Supports [Laravel](https://github.com/laravel/laravel), [Symfony](https://symfony.com), [PHPUnit](https://github.com/sebastianbergmann/phpunit), and many other frameworks.

- Follow the creator Nuno Maduro:
    - YouTube: **[youtube.com/@nunomaduro](https://youtube.com/@nunomaduro)** — Videos every week
    - Twitch: **[twitch.tv/nunomaduro](https://twitch.tv/nunomaduro)** — Live coding on Mondays, Wednesdays, and Fridays at 9PM UTC
    - Twitter / X: **[x.com/enunomaduro](https://x.com/enunomaduro)**
    - LinkedIn: **[linkedin.com/in/nunomaduro](https://www.linkedin.com/in/nunomaduro)**
    - Instagram: **[instagram.com/enunomaduro](https://www.instagram.com/enunomaduro)**
    - Tiktok: **[tiktok.com/@enunomaduro](https://www.tiktok.com/@enunomaduro)**

Installation &amp; Usage
------------------------

[](#installation--usage)

> **Requires [PHP 8.2+](https://php.net/releases/)**

Require Collision using [Composer](https://getcomposer.org):

```
composer require nunomaduro/collision --dev
```

Version Compatibility
---------------------

[](#version-compatibility)

LaravelCollisionPHPUnitPest6.x3.x7.x4.x8.x5.x9.x, 10.x6.x10.x6.x9.x1.x10.x7.x10.x2.x11.x, 12.x8.x10.x, 11.x, 12.x, 13.x2.x, 3.x, 4.x, 5.xAs an example, here is how to require Collision on Laravel 8.x:

```
composer require nunomaduro/collision:^5.0 --dev
```

No adapter
----------

[](#no-adapter)

You need to register the handler in your code:

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

Contributing
------------

[](#contributing)

Thank you for considering to contribute to Collision. All the contribution guidelines are mentioned [here](CONTRIBUTING.md).

You can also follow the twitter account for latest announcements or just come say hi!: [@enunomaduro](https://twitter.com/enunomaduro)

License
-------

[](#license)

Collision is an open-sourced software licensed under the [MIT license](LICENSE.md).

Logo by [Caneco](https://twitter.com/caneco).

###  Health Score

86

—

ExcellentBetter than 100% of packages

Maintenance92

Actively maintained with recent releases

Popularity85

Widely adopted with strong download metrics

Community63

Healthy contributor diversity

Maturity93

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 83.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Recently: every ~59 days

Total

122

Last Release

90d ago

Major Versions

v5.x-dev → v6.0.02022-01-10

v6.x-dev → v7.0.02023-02-07

v7.10.0 → v8.0.02023-12-04

v7.11.0 → v8.5.02024-10-15

v7.12.0 → v8.7.02025-03-14

PHP version history (10 changes)v0.1.0PHP &gt;=7.1

v1.1.5PHP ^7.1

v4.0.0PHP ^7.2.5

v5.0.0-BETA1PHP ^7.3

v5.1.0PHP ^7.3 || ^8.0

v4.x-devPHP ^7.2.5 || ^8.0

v3.1.0PHP ^7.1 || ^8.0

v6.0.0PHP ^8.0.0

v7.0.0PHP ^8.1.0

v8.0.0PHP ^8.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/86cfef5c1f5195df1a9db17a5f8ecb34455e1f0133a725de9acf7f2fb26ac6a1?d=identicon)[nunomaduro](/maintainers/nunomaduro)

---

Top Contributors

[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (853 commits)")[![Jubeki](https://avatars.githubusercontent.com/u/15707543?v=4)](https://github.com/Jubeki "Jubeki (35 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (15 commits)")[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (15 commits)")[![alexander-schranz](https://avatars.githubusercontent.com/u/1698337?v=4)](https://github.com/alexander-schranz "alexander-schranz (15 commits)")[![owenvoke](https://avatars.githubusercontent.com/u/1899334?v=4)](https://github.com/owenvoke "owenvoke (14 commits)")[![fabio-ivona](https://avatars.githubusercontent.com/u/8792274?v=4)](https://github.com/fabio-ivona "fabio-ivona (13 commits)")[![alecrabbit](https://avatars.githubusercontent.com/u/11045453?v=4)](https://github.com/alecrabbit "alecrabbit (12 commits)")[![lukeraymonddowning](https://avatars.githubusercontent.com/u/12202279?v=4)](https://github.com/lukeraymonddowning "lukeraymonddowning (6 commits)")[![karinarastsinskagia](https://avatars.githubusercontent.com/u/32904307?v=4)](https://github.com/karinarastsinskagia "karinarastsinskagia (4 commits)")[![joaorobertopb](https://avatars.githubusercontent.com/u/6556083?v=4)](https://github.com/joaorobertopb "joaorobertopb (4 commits)")[![Krisell](https://avatars.githubusercontent.com/u/25909128?v=4)](https://github.com/Krisell "Krisell (3 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (3 commits)")[![paupenin](https://avatars.githubusercontent.com/u/7164261?v=4)](https://github.com/paupenin "paupenin (3 commits)")[![jnoordsij](https://avatars.githubusercontent.com/u/45041769?v=4)](https://github.com/jnoordsij "jnoordsij (2 commits)")[![ianrodrigues](https://avatars.githubusercontent.com/u/5269377?v=4)](https://github.com/ianrodrigues "ianrodrigues (2 commits)")[![NicolasCARPi](https://avatars.githubusercontent.com/u/3043706?v=4)](https://github.com/NicolasCARPi "NicolasCARPi (2 commits)")[![nshiro](https://avatars.githubusercontent.com/u/14008307?v=4)](https://github.com/nshiro "nshiro (2 commits)")[![andrey-helldar](https://avatars.githubusercontent.com/u/10347617?v=4)](https://github.com/andrey-helldar "andrey-helldar (2 commits)")[![alexmartinfr](https://avatars.githubusercontent.com/u/19224681?v=4)](https://github.com/alexmartinfr "alexmartinfr (2 commits)")

---

Tags

clicollisionconsoleerrorsexceptionshacktoberfestlaravelphpphpcliconsolecommand-linesymfonylaraveldeverrorhandlingartisanlaravel-zero

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/nunomaduro-collision/health.svg)

```
[![Health](https://phpackages.com/badges/nunomaduro-collision/health.svg)](https://phpackages.com/packages/nunomaduro-collision)
```

###  Alternatives

[nunomaduro/laravel-console-menu

Laravel Console Menu is an output method for your Laravel/Laravel Zero commands.

815412.0k48](/packages/nunomaduro-laravel-console-menu)[nunomaduro/laravel-console-task

Laravel Console Task is a output method for your Laravel/Laravel Zero commands.

2582.1M11](/packages/nunomaduro-laravel-console-task)[nunomaduro/laravel-console-summary

A Beautiful Laravel Console Summary for your Laravel/Laravel Zero commands.

662.0M3](/packages/nunomaduro-laravel-console-summary)[nunomaduro/laravel-console-dusk

Laravel Console Dusk allows the usage of Laravel Dusk in Laravel/Laravel Zero artisan commands.

16255.4k7](/packages/nunomaduro-laravel-console-dusk)[nunomaduro/collision-adapter-symfony

Collision's adapter for Symfony applications. Error Reporting for console/command-line PHP applications.

4536.8k3](/packages/nunomaduro-collision-adapter-symfony)[rahul900day/laravel-console-spinner

Laravel Console Spinner is a spinner output for Laravel command line.

76125.4k1](/packages/rahul900day-laravel-console-spinner)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
