Spanish (Español) translation by Rafael Chavarría (you can also view the original English article)
Si te estás preguntando, "¿Qué es Yii?" revisa nuestra Introducción al Framework Yii, la cuál revisa los beneficios de Yii e incluye una vista general de Yii 2.0.
Introducción
En la serie Programando Con Yii2, estoy guiando a los lectores en el uso del Framework Yii2 para PHP.
En el tutorial de hoy, te mostraré cómo instalar el Depurador de Yii2 y exploraremos sus capacidades a detalle. Es un poderoso asistente de programación el cuál es poco utilizado.
Mientras codificas y pruebas tu aplicación, el depurador puede mostrar tu ruta de aplicación, consultas y variables de consulta, características de rendimiento, ajustes de servidor y framework y mucho más. Por favor sígueme a la par para un tour extendido.
Antes de que comencemos, por favor recuerda, trato de participar en las discusiones de abajo. Si tienes una pregunta o sugerencia de tema, por favor publica un comentario abajo o contactame en Twitter @reifman.
Si notas la separación entre los episodios de la serie Programando con Yii, es porque tuve una cirugía de cerebro el año pasado. Gracias por tu paciencia y apoyo--es agradable estar escribiendo de nuevo regularmente, y espero continuar la cobertura de Yii2.
Comenzando
Instalando el Depurador
Primero, necesitarás agregar la librería yiisoft/yii2-debug a composer.json o instalarla manualmente como sigue:
1 |
$ composer require yiisoft/yii2-debug |
2 |
$ composer update |
Hay un par de maneras para configurar el depurador en tu aplicación. La manera más común es hacerlo en la configuración main.php de tu aplicación:
1 |
return [ |
2 |
'bootstrap' => ['debug'], |
3 |
'modules' => [ |
4 |
'debug' => [ |
5 |
'class' => 'yii\debug\Module', |
6 |
],
|
7 |
// ...
|
De manera alternativa, puedes configurar programáticamente el depurador para un modo específico como hice abajo:
1 |
// ...
|
2 |
if (!YII_ENV_TEST) { |
3 |
// configuration adjustments for 'dev' environment
|
4 |
$config['bootstrap'][] = 'debug'; |
5 |
$config['modules']['debug'] = [ |
6 |
'class' => 'yii\debug\Module', |
7 |
'allowedIPs' => ['*'], |
8 |
];
|
9 |
// ...
|
La configuración de arriba deshabilita el depurador durante pruebas de aceptación.
Accediendo al Depurador
Inicialmente, el depurador aparecerá al fondo de la pantalla de tu aplicación:
Sin embargo, dando clic al símbolo menor que a la derecha, puedes minimizar la barra de herramientas como se muestra abajo:
Puedes acceder al depurador en cualquier momento dando clic sobre el o visitando la URL del depurador como se muestra:
1 |
https://localhost:8888/yourapp/index.php/debug/default/index |
La Consola de Depuración
La consola inicial de depuración mostrará la barra de herramientas en la parte superior de tu pantalla y después una lista, de manera descendente en el tiempo, y todas las rutas ejecutadas de tu aplicación por URL:
Dando clic a los elementos Tag de arriba, puedes acceder a información más detallada de depuración para cualquier petición de página dada, incluso si es de hace 10 minutos o una hora.
La Barra de Herramientas
También puedes dar clic a elementos específicos de la barra de herramientas, como Tiempo o DB para brincar directamente a la consola para rendimiento o consultas de base de datos para la página ejecutándose actualmente:
Cada elemento de la barra de herramientas apenas corresponden a los paneles disponibles de depuración:
El Panel de Petición
La página de petición te muestra todas las variables asociadas con una URL específica, desde variables de consulta hasta cookies:
Desde estos panales de consola, siempre puedes dar clic a Todos, Últimos o los 10 últimos para navegar a otras peticiones de URL (hacia delante o hacia atrás):
El Panel de Configuración
El panel de Configuración te muestra detalles sobre el framework actualmente instalado, su número de versión, complementos e información similar para PHP:
De hecho, si continuas desplazando hacia abajo, el panel de Configuración es (en su mayoría) extensivo, incluso aventurándose a los créditos para el equipo de desarrollo de PHP:
El Panel de Registros
Extremadamente útil, los Mensajes de Registro te muestran el rastro de ejecución de tu página de aplicación:
Es especialmente útil para navegar código para encontrar problemas con el código y depurar consultas de la base de datos:
El Panel de Perfilado de Rendimiento
La vista por defecto del panel de Perfilado de Rendimiento te muestra que tanto toma cada elemento de tu petición de página, ej. Duración:
Puedes acomodar por Duración y descubrir los elementos más lentos de tu página:
El Panel de Consultas de Base de Datos
El panel de Consultas de Bases de Datos te muestran mucho de la actividad de la base de datos filtrada:
El Panel de Paquetes de Recursos
En Paquetes de Recursos, te mostraré todos los componentes que Yii está usando en tu página, tales como CSS y JavaScript y de cuáles archivos de recursos están siendo cargados:
El Panel de Mensajes de Correo
En Mensajes de Correo, si la página que estás viendo envió un mensaje usando SwiftMailer de Yii, podrás ver los ajustes de encabezados y campos en este panel:
De manera general, el depurador de Yii2 proporciona una vista amplia y detallada de lo que está pasando en el framework y tu aplicación.
En Conclusión
Espero que hayas disfrutado explorando la consola de depuración de Yii conmigo y haya sido productivo para ti.
Hemos llegado bastante lejos en la serie Yii2, y en este punto especialmente, me gustaría escuchar qué características y peticiones de temas serían más útiles para ti. Puedes publicarlos en los comentarios de abajo o mandarme un correo en mi sitio web Lookahead Consulting.
Si te gustaría saber cuando llegue el siguiente tutorial Yii2, sígueme en Twitter @reifman o revisa mi página de instructor. Mi página de instructor incluirá todos los artículos de esta serie tan pronto sean publicados.
Para explorar una aplicación más avanzada de Yii2 ahora, revisa nuestra serie startup y Planificador de Reuniones. La aplicación está ahora en liberación alfa, y puedes programar reuniones con amigos. También puedes descargar el código--es de código abierto.
Enlaces Relacionados
By
