Nette Documentation Preview

syntax 
Recetas
*******


Política de seguridad de contenidos .[#toc-content-security-policy]
===================================================================

Si su sitio utiliza la Política de Seguridad de Contenidos, tendrá que añadir `'nonce-<value>'` y `'strict-dynamic'` a `script-src` para que Tracy funcione correctamente. Algunos plugins de terceros pueden requerir directivas adicionales.
Nonce no está soportado en la directiva `style-src`, si usa esta directiva necesitará añadir `'unsafe-inline'`, pero esto debería evitarse en modo de producción.

Ejemplo de configuración para [Nette Framework |nette:configuring]:

```neon
http:
	csp:
		script-src: [nonce, strict-dynamic]
```

Ejemplo en PHP puro:

```php
$nonce = base64_encode(random_bytes(20));
header("Content-Security-Policy: script-src 'nonce-$nonce' 'strict-dynamic';");
```


Carga más rápida .[#toc-faster-loading]
=======================================

La integración básica es sencilla, sin embargo si tienes scripts lentos de bloqueo en la página web, pueden ralentizar la carga de Tracy.
La solución es colocar `<?php Tracy\Debugger::renderLoader() ?>` en tu plantilla antes de cualquier script:

```latte
<!DOCTYPE html>
<html>
<head>
	<title>...<title>
	<?php Tracy\Debugger::renderLoader() ?>
	<link rel="stylesheet" href="assets/style.css">
	<script src="https://code.jquery.com/jquery-3.1.1.min.js"></script>
</head>
```


AJAX y peticiones redirigidas .[#toc-ajax-and-redirected-requests]
==================================================================

Tracy puede mostrar Debug bar y Bluescreens para peticiones AJAX y redirecciones. Tracy crea sus propias sesiones, almacena datos en sus propios archivos temporales y utiliza una cookie `tracy-session`.

Tracy también puede configurarse para usar una sesión nativa PHP, que se inicia antes de que Tracy se active:

```php
session_start();
Debugger::setSessionStorage(new Tracy\NativeSession);
Debugger::enable();
```

En caso de que iniciar una sesión requiera una inicialización más compleja, se puede iniciar Tracy inmediatamente (para que pueda manejar cualquier error que se produzca) y después inicializar el manejador de sesión y finalmente informar a Tracy de que la sesión está lista para ser usada usando la función `dispatch()`:

```php
Debugger::setSessionStorage(new Tracy\NativeSession);
Debugger::enable();

// seguido de la inicialización de la sesión
// e iniciar la sesión
session_start();

Debugger::dispatch();
```

La función `setSessionStorage()` existe desde la versión 2.9, antes de eso Tracy siempre usaba la sesión nativa de PHP.


Depurador personalizado .[#toc-custom-scrubber]
===============================================

Scrubber es un filtro que evita que se filtren datos sensibles de los volcados, como contraseñas o credenciales. El filtro es llamado para cada elemento del array u objeto volcado y devuelve `true` si el valor es sensible. En este caso, se imprime `*****` en lugar del valor.

```php
// evita el volcado de valores clave y propiedades como `password`,
// `password_repeat`, `check_password`, `DATABASE_PASSWORD`, etc.
$scrubber = function(string $key, $value, ?string $class): bool
{
	return preg_match('#password#i', $key) && $value !== null;
};

// lo utilizamos para todos los volcados dentro de BlueScreen
Tracy\Debugger::getBlueScreen()->scrubber = $scrubber;
```


Registrador personalizado .[#toc-custom-logger]
===============================================

Podemos crear un logger personalizado para registrar errores, excepciones no capturadas, y también ser llamado por `Tracy\Debugger::log()`. Logger implementa la interfaz [api:Tracy\ILogger].

```php
use Tracy\ILogger;

class SlackLogger implements ILogger
{
	public function log($value, $priority = ILogger::INFO)
	{
		// envía una solicitud a Slack
	}
}
```

Y luego lo activamos:

```php
Tracy\Debugger::setLogger(new SlackLogger);
```

Si usamos el Nette Framework completo, podemos configurarlo en el archivo de configuración de NEON:

```neon
services:
	tracy.logger: SlackLogger
```


Integración Monolog .[#toc-monolog-integration]
-----------------------------------------------

El paquete Tracy proporciona un adaptador PSR-3 que permite la integración de [monolog/monolog](https://github.com/Seldaek/monolog).

```php
$monolog = new Monolog\Logger('main-channel');
$monolog->pushHandler(new Monolog\Handler\StreamHandler($logFilePath, Monolog\Logger::DEBUG));

$tracyLogger = new Tracy\Bridges\Psr\PsrToTracyLoggerAdapter($monolog);
Debugger::setLogger($tracyLogger);
Debugger::enable();

Debugger::log('info'); // escribe: [<TIMESTAMP>] main-channel.INFO: info [] []
Debugger::log('warning', Debugger::WARNING); // escribe: [<TIMESTAMP>] main-channel.WARNING: advertencia [] []
```


nginx .[#toc-nginx]
===================

Si Tracy no funciona en nginx, probablemente esté mal configurado. Si hay algo como

```nginx
try_files $uri $uri/ /index.php;
```

cámbielo por

```nginx
try_files $uri $uri/ /index.php$is_args$args;
```

Recetas

Política de seguridad de contenidos

Si su sitio utiliza la Política de Seguridad de Contenidos, tendrá que añadir 'nonce-<value>' y 'strict-dynamic' a script-src para que Tracy funcione correctamente. Algunos plugins de terceros pueden requerir directivas adicionales. Nonce no está soportado en la directiva style-src, si usa esta directiva necesitará añadir 'unsafe-inline', pero esto debería evitarse en modo de producción.

Ejemplo de configuración para Nette Framework:

http:
	csp:
		script-src: [nonce, strict-dynamic]

Ejemplo en PHP puro:

$nonce = base64_encode(random_bytes(20));
header("Content-Security-Policy: script-src 'nonce-$nonce' 'strict-dynamic';");

Carga más rápida

La integración básica es sencilla, sin embargo si tienes scripts lentos de bloqueo en la página web, pueden ralentizar la carga de Tracy. La solución es colocar <?php Tracy\Debugger::renderLoader() ?> en tu plantilla antes de cualquier script:

<!DOCTYPE html>
<html>
<head>
	<title>...<title>
	<?php Tracy\Debugger::renderLoader() ?>
	<link rel="stylesheet" href="assets/style.css">
	<script src="https://code.jquery.com/jquery-3.1.1.min.js"></script>
</head>

AJAX y peticiones redirigidas

Tracy puede mostrar Debug bar y Bluescreens para peticiones AJAX y redirecciones. Tracy crea sus propias sesiones, almacena datos en sus propios archivos temporales y utiliza una cookie tracy-session.

Tracy también puede configurarse para usar una sesión nativa PHP, que se inicia antes de que Tracy se active:

session_start();
Debugger::setSessionStorage(new Tracy\NativeSession);
Debugger::enable();

En caso de que iniciar una sesión requiera una inicialización más compleja, se puede iniciar Tracy inmediatamente (para que pueda manejar cualquier error que se produzca) y después inicializar el manejador de sesión y finalmente informar a Tracy de que la sesión está lista para ser usada usando la función dispatch():

Debugger::setSessionStorage(new Tracy\NativeSession);
Debugger::enable();

// seguido de la inicialización de la sesión
// e iniciar la sesión
session_start();

Debugger::dispatch();

La función setSessionStorage() existe desde la versión 2.9, antes de eso Tracy siempre usaba la sesión nativa de PHP.

Depurador personalizado

Scrubber es un filtro que evita que se filtren datos sensibles de los volcados, como contraseñas o credenciales. El filtro es llamado para cada elemento del array u objeto volcado y devuelve true si el valor es sensible. En este caso, se imprime ***** en lugar del valor.

// evita el volcado de valores clave y propiedades como `password`,
// `password_repeat`, `check_password`, `DATABASE_PASSWORD`, etc.
$scrubber = function(string $key, $value, ?string $class): bool
{
	return preg_match('#password#i', $key) && $value !== null;
};

// lo utilizamos para todos los volcados dentro de BlueScreen
Tracy\Debugger::getBlueScreen()->scrubber = $scrubber;

Registrador personalizado

Podemos crear un logger personalizado para registrar errores, excepciones no capturadas, y también ser llamado por Tracy\Debugger::log(). Logger implementa la interfaz Tracy\ILogger.

use Tracy\ILogger;

class SlackLogger implements ILogger
{
	public function log($value, $priority = ILogger::INFO)
	{
		// envía una solicitud a Slack
	}
}

Y luego lo activamos:

Tracy\Debugger::setLogger(new SlackLogger);

Si usamos el Nette Framework completo, podemos configurarlo en el archivo de configuración de NEON:

services:
	tracy.logger: SlackLogger

Integración Monolog

El paquete Tracy proporciona un adaptador PSR-3 que permite la integración de monolog/monolog.

$monolog = new Monolog\Logger('main-channel');
$monolog->pushHandler(new Monolog\Handler\StreamHandler($logFilePath, Monolog\Logger::DEBUG));

$tracyLogger = new Tracy\Bridges\Psr\PsrToTracyLoggerAdapter($monolog);
Debugger::setLogger($tracyLogger);
Debugger::enable();

Debugger::log('info'); // escribe: [<TIMESTAMP>] main-channel.INFO: info [] []
Debugger::log('warning', Debugger::WARNING); // escribe: [<TIMESTAMP>] main-channel.WARNING: advertencia [] []

nginx

Si Tracy no funciona en nginx, probablemente esté mal configurado. Si hay algo como

try_files $uri $uri/ /index.php;

cámbielo por

try_files $uri $uri/ /index.php$is_args$args;