Whoops

When an error occurs during development, Magento usually shows only a short message or a blank page, and the details have to be searched in the log files. Whoops integrates the well-known open-source error page “Whoops”, which shows the error, the code that caused it and the full sequence of calls in a readable page right in the browser.

Features

• Detailed error pages for errors and exceptions while the store runs in developer mode, with the error message, the affected code and all request details.
• Also catches fatal errors at the end of a request; for running out of memory, a short plain-text message with the location is shown.
• In production and default mode, the detailed pages are never shown; fatal errors only produce a short note to check the PHP log.
• Test addresses (under /whoops/ in the storefront) that deliberately trigger different kinds of errors in developer mode, to check that error display works. In other modes these addresses show the normal “page not found” page.

Configuration

There is nothing to configure. The error pages are active automatically as soon as the store runs in developer mode.

Good to know

Intended for development and staging environments. In a live store running in production mode, visitors never see the detailed error pages.

Installation

Install the module with Composer in your Magento root directory:

composer require infrangible/m2-whoops

Then enable it and update the store as described in the installation guide. Composer installs the required modules listed on this page automatically.