Konfiguracija Tracy
*******************

Naslednji primeri predpostavljajo, da je definiran naslednji vzdevek razreda:

```php
use Tracy\Debugger;
```


beleženje napak .[#toc-error-logging]
-------------------------------------

```php
$logger = Debugger::getLogger();

// če je prišlo do napake, se obvestilo pošlje na ta e-poštni naslov.
$logger->email = 'dev@example.com';      // (string|string[]) privzeto je nenastavljeno

// pošiljatelj e-pošte
$logger->fromEmail = 'me@example.com';   // (niz) privzeto je nenastavljeno

// postopek za pošiljanje e-pošte
$logger->mailer = /* ... */;             // (klicljiva) privzeto pošiljanje z mail()

// po katerem najkrajšem času se pošlje drugo elektronsko sporočilo?
$logger->emailSnooze = /* ... */;        // (niz) privzeto je '2 dni'

// za katere ravni napak se BlueScreen tudi beleži?
Debugger::$logSeverity = E_WARNING | E_NOTICE;  // privzeto 0 (brez stopnje napake)
```


`dump()` Vedenje
----------------

```php
// največja dolžina niza
Debugger::$maxLength = 150;              // (int) privzeto glede na Tracy

// kako globok bo seznam
Debugger::$maxDepth = 10;                // (int) privzeto po Tracy

// skrivanje vrednosti teh ključev (od različice Tracy 2.8)
Debugger::$keysToHide = ['password', /* ... */];  // (string[]) privzeto je []

// vizualna tema (od različice Tracy 2.8)
Debugger::$dumpTheme = 'dark';           // (light|dark) privzeto je 'light'

// prikaže lokacijo, kjer je bila klicana funkcija dump()?
Debugger::$showLocation = /* ... */;     // (bool) privzeto glede na Tracy
```


Drugo .[#toc-others]
--------------------

```php
// v razvojnem načinu se vam bodo prikazala opozorila o napaki kot BlueScreen
Debugger::$strictMode = /* ... */;       // (bool|int) privzeta vrednost je false, izberete lahko samo določene stopnje napak (npr. E_USER_DEPRECATED | E_DEPRECATED)

// prikaže tiha (@) sporočila o napakah
Debugger::$scream = /* ... */;           // (bool|int) privzeto je false, od različice 2.9 je mogoče izbrati samo določene ravni napak (npr. E_USER_DEPRECATED | E_DEPRECATED)

// oblika povezave, ki se odpre v urejevalniku
Debugger::$editor = /* ... */;           // (niz|null) privzeto je 'editor://open/?file=%file&line=%line'

// pot do predloge s stranjo po meri za napako 500
Debugger::$errorTemplate = /* ... */;    // (niz) privzeto je nenastavljeno

// prikaže Tracy Bar?
Debugger::$showBar = /* ... */;          // (bool) privzeto je true

Debugger::$editorMapping = [
	// original => new
	'/var/www/html' => '/data/web',
	'/home/web' => '/srv/html',
];
```


Okvir Nette .[#toc-nette-framework]
-----------------------------------

Če uporabljate ogrodje Nette, lahko Tracy konfigurirate in v vrstico Tracy Bar dodajate nove plošče s pomočjo konfiguracijske datoteke.
V konfiguracijski datoteki lahko nastavite parametre Tracyja in tudi dodate nove plošče v vrstico Tracy. Te nastavitve se uporabijo šele po ustvarjanju vsebnika DI, zato se napake, ki so se pojavile prej, ne morejo odražati.

Konfiguracija beleženja napak:

```neon
tracy:
	# če je prišlo do napake, se obvestilo pošlje na ta e-poštni naslov.
	email: dev@example.com           # (string|string[]) privzeto je nenastavljeno

	# pošiljatelj e-pošte
	fromEmail: robot@example.com     # (niz) privzeto je nenastavljeno

	# obdobje odloga pošiljanja e-pošte (od Tracy 2.8.8)
	emailSnooze: ...                 # (niz) privzeto je '2 dni'

	# za uporabo poštnega pošiljatelja, določenega v konfiguraciji? (od Tracy 2.5)
	netteMailer: ...                 # (bool) privzeto je true

	# za katere ravni napak se BlueScreen tudi beleži?
	logSeverity: [E_WARNING, E_NOTICE]  # privzeto je []
```

Konfiguracija za funkcijo `dump()`:

```neon
tracy:
	# največja dolžina niza
	maxLength: 150                # (int) privzeto glede na Tracy

	# kako globok bo seznam
	maxDepth: 10                  # (int) privzeto po Tracy

	# skrivanje vrednosti teh ključev (od različice Tracy 2.8)
	keysToHide: [password, pass]  # (string[]) privzeto je []

	# vizualna tema (od različice Tracy 2.8)
	dumpTheme: dark               # (light|dark) privzeto je 'light'

	# prikaže lokacijo, kjer je bila klicana funkcija dump()?
	showLocation: ...             # (bool) privzeto glede na Tracy
```

Namestitev razširitve Tracy:

```neon
tracy:
	# doda palice Tracy Bar
	bar:
		- Nette\Bridges\DITracy\ContainerPanel
		- IncludePanel
		- XDebugHelper('myIdeKey')
		- MyPanel(@MyService)

	# doda plošče v BlueScreen
	blueScreen:
		- DoctrinePanel::renderException
```

Druge možnosti:

```neon
tracy:
	# v razvojnem načinu se vam bodo prikazala opozorila o napaki kot BlueScreen
	strictMode: ...           # privzeta vrednost true

	# prikaže tiha (@) sporočila o napakah
	scream: ...               # privzeta vrednost je false

	# oblika povezave, ki se odpre v urejevalniku
	editor: ...               # (niz) privzeto je 'editor://open/?file=%file&line=%line'

	# pot do predloge s stranjo po meri za napako 500
	errorTemplate: ...        # (niz) privzeto je nenastavljeno

	# prikaže Tracy Bar?
	showBar: ...              # (bool) privzeto je true

	editorMapping:
		# original: new
		/var/www/html: /data/web
		/home/web: /srv/html
```

Vrednosti možnosti `logSeverity`, `strictMode` in `scream` se lahko zapišejo kot polje ravni napak (npr. `[E_WARNING, E_NOTICE]`) ali kot izraz, ki se uporablja v PHP (npr. `E_ALL & ~E_NOTICE`).


Storitve DI .[#toc-di-services]
-------------------------------

Te storitve so dodane vsebniku DI:

| Ime | Vrsta | Opis
|----------------------------------------------------------
| `tracy.logger` | [api:Tracy\ILogger] | logger
| `tracy.blueScreen` | [api:Tracy\BlueScreen] | BlueScreen
| `tracy.bar` | [api:Tracy\Bar] | Tracy Bar