Nette Documentation Preview

syntax
Configurația Tracy
******************

Următoarele exemple presupun că este definit următorul alias de clasă:

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


Jurnalizare erori .[#toc-error-logging]
---------------------------------------

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

// dacă a apărut o eroare, notificarea este trimisă la acest e-mail
$logger->email = 'dev@example.com';      // (string|string[]) este implicit neimpus.

// expeditor e-mail
$logger->fromEmail = 'me@example.com';   // (șir de caractere) implicit la unset

// rutina de trimitere a e-mailului
$logger->mailer = /* ... */;             // (apelabil) implicit trimiterea prin mail()

// după ce timp cel mai scurt se trimite un alt e-mail?
$logger->emailSnooze = /* ... */;        // (string) implicit este "2 zile

// pentru ce niveluri de eroare este înregistrat și BlueScreen?
Debugger::$logSeverity = E_WARNING | E_NOTICE;  // valoarea implicită este 0 (niciun nivel de eroare)
```


`dump()` Comportament
---------------------

```php
// lungimea maximă a șirului de caractere
Debugger::$maxLength = 150;              // (int) implicit conform Tracy

// cât de adâncă va fi lista
Debugger::$maxDepth = 10;                // (int) implicită conform lui Tracy

// ascunde valorile acestor chei (de la Tracy 2.8)
Debugger::$keysToHide = ['password', /* ... */];  // (string[]) valoarea implicită este []

// tema vizuală (de la Tracy 2.8)
Debugger::$dumpTheme = 'dark';           // (light|dark) implicit la "light

// afișează locația în care a fost apelat dump()?
Debugger::$showLocation = /* ... */;     // (bool) implicit în conformitate cu Tracy
```


Altele .[#toc-others]
---------------------

```php
// în modul de dezvoltare, veți vedea avertismente de notificare sau de eroare ca BlueScreen
Debugger::$strictMode = /* ... */;       // (bool|int) implicit la false, puteți selecta doar anumite niveluri de eroare (de exemplu, E_USER_DEPRECATED | E_DEPRECATED)

// afișează mesaje de eroare silențioase (@)
Debugger::$scream = /* ... */;           // (bool|int) valoarea implicită este false, începând cu versiunea 2.9 este posibilă selectarea doar a unor niveluri de eroare specifice (de exemplu, E_USER_DEPRECATED | E_DEPRECATED)

// formatul linkului care trebuie deschis în editor
Debugger::$editor = /* ... */;           // (string|null) valoarea implicită este "editor://open/?file=%file&line=%line

// calea către șablonul cu pagina personalizată pentru eroarea 500
Debugger::$errorTemplate = /* ... */;    // (șir de caractere) setează implicit la unset

// afișează bara Tracy?
Debugger::$showBar = /* ... */;          // (bool) valoarea implicită este true

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


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

Dacă utilizați Nette Framework, puteți configura Tracy și adăuga noi panouri la bara Tracy folosind fișierul de configurare.
Puteți seta parametrii Tracy în configurație și, de asemenea, puteți adăuga noi panouri la bara Tracy. Aceste setări se aplică numai după ce a fost creat containerul DI, astfel încât erorile care au avut loc anterior nu le pot reflecta.

Configurarea jurnalizării erorilor:

```neon
tracy:
	# dacă a apărut o eroare, notificarea este trimisă la acest e-mail
	email: dev@example.com           # (string|string[]) este implicit neimpus.

	# expeditor e-mail
	fromEmail: robot@example.com     # (șir de caractere) implicit la unset

	# perioada de amânare a trimiterii e-mailurilor (de la Tracy 2.8.8)
	emailSnooze: ...                 # (șir de caractere) implicit la "2 zile

	# pentru a utiliza un expeditor definit în configurație? (de la Tracy 2.5)
	netteMailer: ...                 # (bool) implicit la true

	# pentru care niveluri de eroare este înregistrat și BlueScreen?
	logSeverity: [E_WARNING, E_NOTICE]  # valoarea implicită este []
```

Configurație pentru funcția `dump()`:

```neon
tracy:
	# lungimea maximă a șirului de caractere
	maxLength: 150                # (int) implicit conform Tracy

	# cât de adâncă va fi lista
	maxDepth: 10                  # (int) implicită conform lui Tracy

	# ascunde valorile acestor chei (de la Tracy 2.8)
	keysToHide: [password, pass]  # (string[]) valoarea implicită este []

	# tema vizuală (de la Tracy 2.8)
	dumpTheme: dark               # (light|dark) implicit la "light

	# afișează locația în care a fost apelat dump()?
	showLocation: ...             # (bool) implicit în conformitate cu Tracy
```

Pentru a instala extensia Tracy:

```neon
tracy:
	# adaugă bare la Tracy Bar
	bar:
		- Nette\Bridges\DITracy\ContainerPanel
		- IncludePanel
		- XDebugHelper('myIdeKey')
		- MyPanel(@MyService)

	# adaugă panouri la BlueScreen
	blueScreen:
		- DoctrinePanel::renderException
```

Alte opțiuni:

```neon
tracy:
	# în modul de dezvoltare, veți vedea avertismente de notificare sau de eroare ca BlueScreen
	strictMode: ...           # este implicit la true

	# afișează mesaje de eroare silențioase (@)
	scream: ...               # implicit la false

	# formatul linkului pentru a se deschide în editor
	editor: ...               # (șir de caractere) valoarea implicită este "editor://open/?file=%file&line=%line

	# calea către șablonul cu pagina personalizată pentru eroarea 500
	errorTemplate: ...        # (șir de caractere) implicit la unset

	# afișează bara Tracy?
	showBar: ...              # (bool) valoarea implicită este true

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

Valorile opțiunilor `logSeverity`, `strictMode` și `scream` pot fi scrise sub forma unui tablou de niveluri de eroare (de exemplu: , și ). `[E_WARNING, E_NOTICE]`) sau ca o expresie utilizată în PHP (de exemplu, `E_ALL & ~E_NOTICE`).


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

Aceste servicii sunt adăugate la containerul DI:

Nume | Tip | Tip | Descriere
|----------------------------------------------------------
| `tracy.logger` | [api:Tracy\ILogger] | logger
| `tracy.blueScreen` | [api:Tracy\BlueScreen] | BlueScreen
| `tracy.bar` | [api:Tracy\Bar] | Tracy Bar

Configurația Tracy

Următoarele exemple presupun că este definit următorul alias de clasă:

use Tracy\Debugger;

Jurnalizare erori

$logger = Debugger::getLogger();

// dacă a apărut o eroare, notificarea este trimisă la acest e-mail
$logger->email = 'dev@example.com';      // (string|string[]) este implicit neimpus.

// expeditor e-mail
$logger->fromEmail = 'me@example.com';   // (șir de caractere) implicit la unset

// rutina de trimitere a e-mailului
$logger->mailer = /* ... */;             // (apelabil) implicit trimiterea prin mail()

// după ce timp cel mai scurt se trimite un alt e-mail?
$logger->emailSnooze = /* ... */;        // (string) implicit este "2 zile

// pentru ce niveluri de eroare este înregistrat și BlueScreen?
Debugger::$logSeverity = E_WARNING | E_NOTICE;  // valoarea implicită este 0 (niciun nivel de eroare)

dump() Comportament

// lungimea maximă a șirului de caractere
Debugger::$maxLength = 150;              // (int) implicit conform Tracy

// cât de adâncă va fi lista
Debugger::$maxDepth = 10;                // (int) implicită conform lui Tracy

// ascunde valorile acestor chei (de la Tracy 2.8)
Debugger::$keysToHide = ['password', /* ... */];  // (string[]) valoarea implicită este []

// tema vizuală (de la Tracy 2.8)
Debugger::$dumpTheme = 'dark';           // (light|dark) implicit la "light

// afișează locația în care a fost apelat dump()?
Debugger::$showLocation = /* ... */;     // (bool) implicit în conformitate cu Tracy

Altele

// în modul de dezvoltare, veți vedea avertismente de notificare sau de eroare ca BlueScreen
Debugger::$strictMode = /* ... */;       // (bool|int) implicit la false, puteți selecta doar anumite niveluri de eroare (de exemplu, E_USER_DEPRECATED | E_DEPRECATED)

// afișează mesaje de eroare silențioase (@)
Debugger::$scream = /* ... */;           // (bool|int) valoarea implicită este false, începând cu versiunea 2.9 este posibilă selectarea doar a unor niveluri de eroare specifice (de exemplu, E_USER_DEPRECATED | E_DEPRECATED)

// formatul linkului care trebuie deschis în editor
Debugger::$editor = /* ... */;           // (string|null) valoarea implicită este "editor://open/?file=%file&line=%line

// calea către șablonul cu pagina personalizată pentru eroarea 500
Debugger::$errorTemplate = /* ... */;    // (șir de caractere) setează implicit la unset

// afișează bara Tracy?
Debugger::$showBar = /* ... */;          // (bool) valoarea implicită este true

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

Cadrul Nette

Dacă utilizați Nette Framework, puteți configura Tracy și adăuga noi panouri la bara Tracy folosind fișierul de configurare. Puteți seta parametrii Tracy în configurație și, de asemenea, puteți adăuga noi panouri la bara Tracy. Aceste setări se aplică numai după ce a fost creat containerul DI, astfel încât erorile care au avut loc anterior nu le pot reflecta.

Configurarea jurnalizării erorilor:

tracy:
	# dacă a apărut o eroare, notificarea este trimisă la acest e-mail
	email: dev@example.com           # (string|string[]) este implicit neimpus.

	# expeditor e-mail
	fromEmail: robot@example.com     # (șir de caractere) implicit la unset

	# perioada de amânare a trimiterii e-mailurilor (de la Tracy 2.8.8)
	emailSnooze: ...                 # (șir de caractere) implicit la "2 zile

	# pentru a utiliza un expeditor definit în configurație? (de la Tracy 2.5)
	netteMailer: ...                 # (bool) implicit la true

	# pentru care niveluri de eroare este înregistrat și BlueScreen?
	logSeverity: [E_WARNING, E_NOTICE]  # valoarea implicită este []

Configurație pentru funcția dump():

tracy:
	# lungimea maximă a șirului de caractere
	maxLength: 150                # (int) implicit conform Tracy

	# cât de adâncă va fi lista
	maxDepth: 10                  # (int) implicită conform lui Tracy

	# ascunde valorile acestor chei (de la Tracy 2.8)
	keysToHide: [password, pass]  # (string[]) valoarea implicită este []

	# tema vizuală (de la Tracy 2.8)
	dumpTheme: dark               # (light|dark) implicit la "light

	# afișează locația în care a fost apelat dump()?
	showLocation: ...             # (bool) implicit în conformitate cu Tracy

Pentru a instala extensia Tracy:

tracy:
	# adaugă bare la Tracy Bar
	bar:
		- Nette\Bridges\DITracy\ContainerPanel
		- IncludePanel
		- XDebugHelper('myIdeKey')
		- MyPanel(@MyService)

	# adaugă panouri la BlueScreen
	blueScreen:
		- DoctrinePanel::renderException

Alte opțiuni:

tracy:
	# în modul de dezvoltare, veți vedea avertismente de notificare sau de eroare ca BlueScreen
	strictMode: ...           # este implicit la true

	# afișează mesaje de eroare silențioase (@)
	scream: ...               # implicit la false

	# formatul linkului pentru a se deschide în editor
	editor: ...               # (șir de caractere) valoarea implicită este "editor://open/?file=%file&line=%line

	# calea către șablonul cu pagina personalizată pentru eroarea 500
	errorTemplate: ...        # (șir de caractere) implicit la unset

	# afișează bara Tracy?
	showBar: ...              # (bool) valoarea implicită este true

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

Valorile opțiunilor logSeverity, strictMode și scream pot fi scrise sub forma unui tablou de niveluri de eroare (de exemplu: , și ). [E_WARNING, E_NOTICE]) sau ca o expresie utilizată în PHP (de exemplu, E_ALL & ~E_NOTICE).

Servicii DI

Aceste servicii sunt adăugate la containerul DI:

Nume | Tip | Tip | Descriere

tracy.logger Tracy\ILogger logger
tracy.blueScreen Tracy\BlueScreen BlueScreen
tracy.bar Tracy\Bar Tracy Bar