In the world of modern PHP development, transparency and documentation are crucial for debugging, auditing, and collaborating effectively. For Laravel developers, generating detailed reports about the application’s environment, configuration, and dependencies is often essential—especially when handing off projects or seeking help. This is where Laravel Decomposer shines.

Laravel Decomposer is a simple, developer-friendly package that displays a full breakdown of your Laravel application in your browser. It’s a handy tool for developers who want quick insight into their app's setup without writing a single line of code.

What is Laravel Decomposer?

Laravel Decomposer is a package created by Lubusin that allows you to generate a detailed, shareable system report of your Laravel application. The report includes:

• Laravel version

• PHP version and extensions

• Installed packages and their versions

• Server and OS details

• App configuration settings

• Cache and queue drivers

• File permissions

It works seamlessly in development environments and is especially useful when working in teams or debugging across different systems.

Why Use Laravel Decomposer?

Here are several reasons Laravel Decomposer is worth using in your projects:

✅ Instant Overview

Get an at-a-glance summary of your entire app’s infrastructure.

✅ Debugging Support

Quickly spot mismatches in PHP versions, missing extensions, or misconfigured drivers.

✅ Easy Collaboration

Send a direct report link to team members or support forums when reporting issues.

✅ Lightweight and Secure

No performance overhead, and access to the decomposer route can be restricted in production.

How to Install Laravel Decomposer

You can install Laravel Decomposer via Composer with a single command:

composer require lubusin/laravel-decomposer --dev

Then, publish the config file if you want to customize anything:

php artisan vendor:publish --tag=decomposer-config

Once installed, navigate to:

/decomposer

in your browser (e.g., http://your-app.test/decomposer) to view the report.

Features and Output

The Laravel Decomposer screen is divided into several sections:

1. Application Details
   Laravel version, URL, timezone, locale, etc.

2. Server Environment
   PHP version, server software, OS, loaded extensions, memory limit, etc.

3. Installed Packages
   Displays the list of Composer packages used with their versions and dependencies.

4. File Permissions Check
   Checks if storage, cache, and log folders are writable.

5. Cache and Queue Configuration
   Shows which drivers are currently in use.

Each section provides valuable insights and can help you resolve misconfigurations without digging into multiple config files or terminal commands.

Security Best Practices

While Laravel Decomposer is incredibly helpful during development, it should not be used in production without proper access controls. Here are some tips:

• Only include the package in the --dev environment.

• Use middleware to restrict access to authenticated users or IPs.

• Remove or disable the route before deploying to production servers.

Final Thoughts

Laravel Decomposer is a must-have tool for any Laravel developer looking to simplify environment diagnostics and improve collaboration. It offers a full technical snapshot of your app in seconds and can save hours of troubleshooting time.

Whether you're debugging a stubborn issue, onboarding a new team member, or preparing an app for deployment, Laravel Decomposer helps you work smarter and faster.

Want to level up your Laravel toolbox? Try integrating Laravel Decomposer into your next project and see how much easier maintenance becomes.