Depurando WordPress con Ray, Parte 1
TL;DR: Esta publicación brinda una descripción general de alto nivel de qué tipo de aplicación es Ray y cómo configurarla para su uso en WordPress.
Durante el tiempo que he estado involucrado con el desarrollo de WordPress, he visto constantemente a los desarrolladores, incluido yo mismo, usar constantemente [print_r](https://www.php.net/manual/en/function.print-r.php)y [var_dump](https://www.php.net/manual/en/function.var-dump.php)cada vez que necesitan ver lo que sucede dentro de su código.
Y esto está bien para estructuras de datos más pequeñas, como miradas a objetos, matrices, etc. Luego, en el otro extremo del espectro de depuración, si necesita recorrer el código para ver qué argumentos se pasan a una función determinada desde dónde y con qué valor, usar algo como Xdebug es increíblemente útil.
Hasta hace poco, no creía que hubiera término medio. Pero luego encontré a Ray y lo he estado usando desde entonces.
Depurando WordPress con Ray, Parte 1
¿Qué es Rayo?
Antes de hablar sobre la depuración de WordPress con Ray, vale la pena entender qué es Ray y qué no es.
El primero es que no es algo que sea exclusivamente de WordPress, por lo que si se topó con esta publicación como alguien más en la comunidad PHP más amplia, es algo que todavía está en proceso de verificar.
Dicho esto, supongamos que usted es un desarrollador basado en WordPress y está buscando aprender más sobre de qué se trata Ray.
En primer lugar, aunque proporciona un ejemplo elegante de cómo se ve su código cuando se descarga en una pantalla, ofrece mucho más.
Tenga en cuenta que cuando usa Ray, necesitará algunas herramientas adicionales, que cubriré un poco más en un momento, pero si desea continuar volcando información en un formato similar a var_dumpRay admite eso. Simplemente hace que se vea mejor. 🙂
En segundo lugar, cuando invoca a Ray desde su código, se asegurará de que sepa de dónde proviene la llamada. De esta manera, sabrá exactamente qué archivo y qué línea está buscando. Esto es útil especialmente cuando tiene varias llamadas.
En tercer lugar, puede pausar la ejecución de su código como lo hace cuando usa un depurador real. Esto significa que una vez que llega a cierto punto en su código (y esto es útil si está alcanzando una switchcondición o una ifcondición o si está usando, digamos, una fábrica en programación orientada a objetos y quiere saber qué instancia de se ha creado una instancia de un objeto), entonces puede detener la ejecución y tener una mejor idea de lo que está pasando con su proyecto.
Finalmente, puede organizar los tipos de salida en varios colores. Esto significa que si accede a una determinada rama en el código y no desea acceder a esa rama, puede categorizarla como roja. Del mismo modo, puedes hacer lo mismo con verde, naranja, morado y más. Realmente depende de usted y de lo que pretende lograr al observar sus datos.
Usando Ray en WordPres
Si lee los documentos para instalar Ray en WordPress, puede parecer un poco intimidante (especialmente dependiendo de su experiencia con la CLI, con Git y con complementos imprescindibles).
Lo bueno es que no tiene por qué ser así. En su lugar, puede obtener el complemento Ray de WordPress del repositorio de complementos (ya sea desde el sitio o desde WordPress, según sus permisos).
Una vez que se haya instalado el complemento, debería poder comenzar a volcar información en Ray de inmediato.
Usando Git y Composer
Si opta por usar Git y Composer, asegúrese de que esas dos herramientas estén instaladas en su sistema, luego haga lo siguiente.
Primero, clone el repositorio en su mu-pluginsdirectorio emitiendo el siguiente comando:
psgit clone git@github.com:spatie/wordpress-ray
Luego, navegue a ese directorio en su terminal y ejecute:
$ composer install
Una vez que ese proceso haya terminado, abra wp-config.phpy agregue las siguientes dos líneas:
require_once ABSPATH. 'wp-content/mu-plugins/wordpress-ray/wp-ray.php';
define( 'WP_ENVIRONMENT_TYPE', 'local' );
Después de eso, puede comenzar a usar la rayfunción en su código. Por ejemplo, tengo la siguiente línea de código ejecutándose en una plantilla que estoy usando como demostración para este artículo:
<?php ray( wp_get_current_user() ); ?>
Luego, siempre que se cargue esta página, la aplicación Ray mostrará lo siguiente:
Obviamente, esta es información rica, información que aún se puede leer por otros medios, pero de una manera mucho más elegante.
para la parte 2
En la Parte 2 de la serie, cubriré cómo comenzar a depurar código usando Ray y por qué disfruto usar la aplicación como un término medio entre algo [var_dump](https://www.php.net/manual/es/function.var-dump.php)como Xdebug.
Además, revisaré algunas de las características específicas de WordPress de Ray para que pueda ver cómo esto es más que "una forma bonita de volcar variables".
En última instancia, creo que Xdebug todavía es algo que debería usarse, pero Ray es un término medio mucho más agradable que proporciona una gran cantidad de funciones de depuración sólidas sin necesidad de la asistencia completa de un verdadero depurador.