Jednoduché rozšíření Nette které zajištuje zobrazení názvu souboru se zalogovanou exception při zobrazení chyby 500 v produkčním režimu (viz. obrázek níže).

• PHP 8.2 – 8.5
• nette/application 3.2 – 3.3, nette/http 3.3 – 3.4, nette/utils 4.0.4 – 4.1, tracy/tracy 2.10 – 2.x (nette/application 3.3 a nette/http 3.4 samy vyžadují PHP 8.3+, na PHP 8.2 se proto použije nette/application 3.2 a nette/http 3.3)
• nette/database 3.1.7 – 3.2 (volitelně, pouze pro ErrorHandlerModule\Logger\DeadlockLogger)

• Nainstalujte balíček přes příkaz: composer require pavlista/nette-error-handler.
• V konfiguraci nette zaregistrujte nový error presenter.

application:
    errorPresenter: ErrorHandler:Error

• Do souboru boostrap.php přidejte ihned pod $configurator->enableTracy(__DIR__ . '/../log'); registraci error handleru:

ErrorHandlerModule\ErrorHandler::register();

Modul potřebuje ke zjištění názvu souboru s chybou přístup ke standardnímu Tracy\Logger. Pokud aplikace v Tracy registruje vlastní Tracy\ILogger, který standardní logger obaluje (místo aby z něj dědil), zaregistrujte v bootstrapu funkci, která jej z něj získá:

ErrorHandlerModule\ErrorHandler::setLoggerResolver(
    static fn (Tracy\ILogger $logger): ?Tracy\Logger =>
        $logger instanceof MyWrappingLogger ? $logger->getInnerLogger() : null,
);

Bez toho vrací ErrorHandler::getErrorFile() prázdný řetězec a ErrorHandler::activateLogDispatcher() nepřenese do LogDispatcher nastavení odesílání e-mailů (fromEmail, emailSnooze, mailer).

Resolver musí být nastaven před prvním voláním ErrorHandler::activateLogDispatcher() — nastavení e-mailů se přenáší pouze při vytvoření LogDispatcheru a později se už nedoplní.

Pozor: ErrorHandler::activateLogDispatcher() nastaví do Tracy LogDispatcher a váš obalující logger tím zcela nahradí — resolver z něj přenese jen zmíněné nastavení, ne jeho chování při logování.

Vlastní chybovou šablonu předávejte výhradně přes ErrorHandler::register():

ErrorHandlerModule\ErrorHandler::register(__DIR__ . '/../app/error.500.phtml');

Nekombinujte modul s volbou errorTemplate v konfiguraci Tracy:

tracy:
    errorTemplate: ...   # nepoužívat společně s tímto modulem

DI kontejner tuto hodnotu nastavuje až po zavolání ErrorHandler::register() v bootstrapu. Modul si při každé kritické chybě ověřuje, že šablona v Tracy odpovídá té, kterou zaregistroval — při rozdílu se sám deaktivuje výjimkou Tracy error template changed, error handler is disabled a chybová stránka se nevykreslí.

Statická analýza běží v Dockeru nad oficiálními php:*-cli image (viz docker/Dockerfile), takže lokálně stačí mít Docker a make:

Verzi PHP lze zvolit přes PHP=85, např. make c PHP=85. Default je nejnižší podporovaná verze.