Tracy integrace do Nette

Tags

nettetracyphp

Cover

Date

2018/01/14

Tracy jiste každý, kdo používa Nette, zná, ale znáte všechny její nastavení?

Tracy je skvělý nástroj, už si nedovedu představit projekt bez ní. Všichni ji používáme v rámci Nette Frameworku. Má dokonce i svůj web (https://tracy.nette.org/).

Někdo ji používá i samostatně, jenom aby se mu dobře vyvíjelo. To je určitě validní přístup. Já bych se však rád podíval na Tracy integraci v rámci Nette, protože tam je cesta dosti neprobádaná.

Aktuální dokumentace hovoří o pár konfiguračních hodnotách. Následující nastavení můžete vložit přímo do souboru config.neon.

tracy:
    email: %webmasterEmail%
    strictMode: true
    editor: ...
    browser: ...
    bar: # panely do Debugger baru
        - Nette\Bridges\DITracy\ContainerPanel # alias DI Container baru
        - IncludePanel
        - XDebugHelper('myIdeKey')
        - MyPanel(@MyService)
    blueScreen: # panely do Laděnky
        - DoctrinePanel::renderException

V rámci jednoho PR jsem se pokusil zachytit a popsat všechny nastavení, které Tracy můžete předat.

PR: https://github.com/nette/docs/pull/669

tracy:
    # email, na který se posílají notifikace, že došlo k chybě
    email: [email protected]
    fromEmail: [email protected]

    # ve vývojovém režimu zobrazí chyby typu notice nebo warning jako BlueScreen
    strictMode: true

    # zobrazí umlčené (@) chybové hlášky
    scream: true

    # formát odkazu pro otevření v editoru
    editor: editor://open/?file=%file&line=%line

    # cesta k prohlížeči, který bude automaticky otevírat zalogované BlueScreen v CLI režimu
    browser: ...

    # pro jaké úrovně chyb (E_WARNING, E_ALL, ...) se loguje i BlueScreen
    logSeverity:

    # cesta k šabloně s vlastní stránkou pro chybu 500
    errorTemplate: ...

    # zobrazí Debugger Bar na spodu stránky
    showBar: true

    # maximální délka řetězce vypisovaná funkcí dump()
    maxLength: 150

    # do kolika úrovní zanoření má vypisovat funkce dump()
    maxDepth: 3

    # zobrazí místo, kde byla volána funkce dump()
    showLocation: false

    editorMapping:
        # originál: nová
        /var/www/html: /data/web
        /home/web: /srv/html

    # přidá panely do Debugger Baru
    bar:
        - Nette\Bridges\DITracy\ContainerPanel
        - IncludePanel
        - XDebugHelper('myIdeKey')
        - MyPanel(@MyService)

    # přidá panely do BlueScreen
    blueScreen:
        - DoctrinePanel::renderException

I mě samotného překvapilo, kolik částí se dá konfigurovat. Například browser je dost magická volba, použije se tehdy, když spouštíte script z CLI a zaloguje se laděnka. Tehdy Tracy zjistí, jestli je browser nastavený a připadně vám přes exec zavolá tento kód. V praxi se vám otevře prohlížeč s právě vyhozenou výjimkou.