Konfiguracija Tracy

Naslednji primeri predpostavljajo, da je definiran naslednji vzdevek razreda:

use Tracy\Debugger;

beleženje napak

$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

// 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

// 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

Č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:

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():

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:

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:

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

Te storitve so dodane vsebniku DI:

Ime	Vrsta	Opis
`tracy.logger`	Tracy\ILogger	logger
`tracy.blueScreen`	Tracy\BlueScreen	BlueScreen
`tracy.bar`	Tracy\Bar	Tracy Bar