Tracy Konfiguration
Alle Beispiele gehen von einem erstellten Alias aus:
use Tracy\Debugger;
Fehlerprotokollierung
$logger = Debugger::getLogger();
// E-Mail, an die Benachrichtigungen über aufgetretene Fehler gesendet werden
$logger->email = 'dev@example.com'; // (string|string[]) Standardmäßig nicht festgelegt
// Absender der E-Mail
$logger->fromEmail = 'me@example.com'; // (string) Standardmäßig nicht festgelegt
// Routine, die das Senden der E-Mail sicherstellt
$logger->mailer = /* ... */; // (callable) Standardmäßig wird mit der mail()-Funktion gesendet
// Nach welcher kürzesten Zeit die nächste E-Mail senden?
$logger->emailSnooze = /* ... */; // (string) Standard ist '2 days'
// Für welche Fehlerstufen wird auch der BlueScreen protokolliert?
Debugger::$logSeverity = E_WARNING | E_NOTICE; // Standard ist 0 (keine Fehlerstufen)
Verhalten von dump()
// Maximale Länge der Zeichenkette
Debugger::$maxLength = 150; // (int) Standard gemäß Tracy-Version
// Maximale Verschachtelungstiefe
Debugger::$maxDepth = 10; // (int) Standard gemäß Tracy-Version
// Werte dieser Schlüssel ausblenden (ab Tracy 2.8)
Debugger::$keysToHide = ['password', /* ... */]; // (string[]) Standard ist []
// Visuelles Thema (ab Tracy 2.8)
Debugger::$dumpTheme = 'dark'; // (light|dark) Standard ist 'light'
// Ort anzeigen, an dem die dump()-Funktion aufgerufen wurde?
Debugger::$showLocation = /* ... */; // (bool) Standard gemäß Tracy-Version
Sonstiges
// Im Entwicklungsmodus werden Fehler vom Typ Notice oder Warning als BlueScreen angezeigt
Debugger::$strictMode = /* ... */; // (bool|int) Standard ist false, es können nur bestimmte Fehlerstufen ausgewählt werden (z.B. E_USER_DEPRECATED | E_DEPRECATED)
// Unterdrückte (@) Fehlermeldungen anzeigen?
Debugger::$scream = /* ... */; // (bool|int) Standard ist false, ab Version 2.9 können nur bestimmte Fehlerstufen ausgewählt werden (z.B. E_USER_DEPRECATED | E_DEPRECATED)
// Linkformat zum Öffnen im Editor
Debugger::$editor = /* ... */; // (string|null) Standard ist 'editor://open/?file=%file&line=%line'
// Pfad zum Template mit einer benutzerdefinierten Seite für Fehler 500
Debugger::$errorTemplate = /* ... */; // (string) Standardmäßig nicht festgelegt
// Tracy Bar anzeigen?
Debugger::$showBar = /* ... */; // (bool) Standard ist true
Debugger::$editorMapping = [
// Original => Neu
'/var/www/html' => '/data/web',
'/home/web' => '/srv/html',
];
Nette Framework
Wenn Sie das Nette Framework verwenden, können Sie Tracy konfigurieren und neue Panels zur Tracy Bar auch über die Konfigurationsdatei hinzufügen. In der Konfiguration können Parameter eingestellt und auch neue Panels zur Tracy Bar hinzugefügt werden. Diese Einstellungen werden erst nach der Erstellung des DI-Containers angewendet, sodass Fehler, die davor auftreten, diese nicht widerspiegeln können.
Konfiguration der Fehlerprotokollierung:
tracy:
# E-Mail, an die Benachrichtigungen über aufgetretene Fehler gesendet werden
email: dev@example.com # (string|string[]) Standardmäßig nicht festgelegt
# Absender der E-Mail
fromEmail: robot@example.com # (string) Standardmäßig nicht festgelegt
# Verzögerungszeit für den E-Mail-Versand (ab Tracy 2.8.8)
emailSnooze: ... # (string) Standard ist '2 days'
# Nette Mailer zum Senden von E-Mails verwenden? (ab Tracy 2.5)
netteMailer: ... # (bool) Standard ist true
# Für welche Fehlerstufen wird auch der BlueScreen protokolliert?
logSeverity: [E_WARNING, E_NOTICE] # Standard ist []
Konfiguration des Verhaltens der dump()
-Funktion:
tracy:
# Maximale Länge der Zeichenkette
maxLength: 150 # (int) Standard gemäß Tracy-Version
# Maximale Verschachtelungstiefe
maxDepth: 10 # (int) Standard gemäß Tracy-Version
# Werte dieser Schlüssel ausblenden (ab Tracy 2.8)
keysToHide: [password, pass] # (string[]) Standard ist []
# Visuelles Thema (ab Tracy 2.8)
dumpTheme: dark # (light|dark) Standard ist 'light'
# Ort anzeigen, an dem die dump()-Funktion aufgerufen wurde?
showLocation: ... # (bool) Standard gemäß Tracy-Version
Installation von Tracy-Erweiterungen:
tracy:
# Fügt Panels zur Tracy Bar hinzu
bar:
- Nette\Bridges\DITracy\ContainerPanel
- IncludePanel
- XDebugHelper('myIdeKey')
- MyPanel(@MyService)
# Fügt Panels zum BlueScreen hinzu
blueScreen:
- DoctrinePanel::renderException
Andere Optionen:
tracy:
# Im Entwicklungsmodus werden Fehler vom Typ Notice oder Warning als BlueScreen angezeigt
strictMode: ... # Standard ist true
# Unterdrückte (@) Fehlermeldungen anzeigen?
scream: ... # Standard ist false
# Linkformat zum Öffnen im Editor
editor: ... # (string) Standard ist 'editor://open/?file=%file&line=%line'
# Pfad zum Template mit einer benutzerdefinierten Seite für Fehler 500
errorTemplate: ... # (string) Standardmäßig nicht festgelegt
# Tracy Bar anzeigen?
showBar: ... # (bool) Standard ist true
editorMapping:
# Original: Neu
/var/www/html: /data/web
/home/web: /srv/html
Die Werte der Optionen logSeverity
, strictMode
und scream
können als Array von
Fehlerebenen (z.B. [E_WARNING, E_NOTICE]
) oder als in PHP verwendeter Ausdruck (z.B.
E_ALL & ~E_NOTICE
) geschrieben werden.
DI-Dienste
Diese Dienste werden dem DI-Container hinzugefügt:
Name | Typ | Beschreibung |
---|---|---|
tracy.logger |
Tracy\ILogger | Logger |
tracy.blueScreen |
Tracy\BlueScreen | BlueScreen |
tracy.bar |
Tracy\Bar | Tracy Bar |