{"id":142,"date":"2023-02-14T00:00:00","date_gmt":"2023-02-13T23:00:00","guid":{"rendered":"https:\/\/helloblog.io\/es\/depurar-wordpress-acorn-wp-debug\/"},"modified":"2026-01-20T06:32:44","modified_gmt":"2026-01-20T05:32:44","slug":"depurar-wordpress-acorn-wp-debug","status":"publish","type":"post","link":"https:\/\/helloblog.io\/es\/depurar-wordpress-acorn-wp-debug\/","title":{"rendered":"Depurar WordPress sin sufrir: c\u00f3mo mejora Acorn la salida de WP_DEBUG"},"content":{"rendered":"\n

En desarrollo, WP_DEBUG<\/code> es de esas constantes que deber\u00edan estar activadas siempre: te avisa de notices<\/em>, warnings<\/em> y errores que, si los dejas pasar, terminan convirti\u00e9ndose en bugs dif\u00edciles de rastrear en staging o producci\u00f3n. El problema es que la experiencia \u201cde serie\u201d en WordPress es bastante espartana: te imprime mensajes en pantalla y poco m\u00e1s.<\/p>\n\n\n\n

Si trabajas con stacks modernos alrededor de WordPress (por ejemplo Bedrock, el boilerplate de Roots gestionado con Composer), la parte buena es que el modo debug ya suele venir activado en entornos de desarrollo. La parte mejor es que, si adem\u00e1s usas Acorn<\/strong>, el salto de calidad en el manejo de excepciones es enorme: pasas de texto suelto a p\u00e1ginas de error estructuradas, con stack traces<\/em> navegables y contexto \u00fatil.<\/p>\n\n\n\n

Qu\u00e9 hace realmente WP_DEBUG (y por qu\u00e9 su salida se queda corta)<\/h2>\n\n\n\n

WP_DEBUG<\/code> es el interruptor principal del modo debug en WordPress. Cuando est\u00e1 activo, WordPress muestra (y\/o registra) avisos y errores de PHP que, de otro modo, podr\u00edan quedar ocultos. En un proyecto con plugins, mu-plugins y temas de terceros, esto es oro: el ecosistema est\u00e1 lleno de extensiones que emiten notices<\/em> constantemente.<\/p>\n\n\n\n

El punto d\u00e9bil es la presentaci\u00f3n<\/strong>: el output por defecto tiende a aparecer incrustado en la p\u00e1gina, sin estructura, con poca jerarqu\u00eda visual y sin herramientas para inspeccionar r\u00e1pidamente d\u00f3nde se origin\u00f3 el problema.<\/p>\n\n\n\n

\"Salida
El output nativo de WP_DEBUG funciona, pero no ayuda demasiado cuando el error es complejo. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Acorn y el \u201cdebug moderno\u201d en WordPress<\/h2>\n\n\n\n

Acorn es el framework de Roots que lleva piezas del ecosistema Laravel a WordPress (contenedor, configuraci\u00f3n, helpers, y en versiones recientes tambi\u00e9n routing). En la pr\u00e1ctica, adem\u00e1s de mejorar tu arquitectura PHP, tambi\u00e9n mejora la experiencia de depuraci\u00f3n cuando tienes WP_DEBUG<\/code> activo.<\/p>\n\n\n\n

\n\n

Cu\u00e1ndo ver\u00e1s la mejora<\/h4>\n\n\n

Seg\u00fan la documentaci\u00f3n de Roots, Acorn mejora la salida de errores cuando est\u00e1n activos WP_DEBUG<\/code> y WP_DEBUG_DISPLAY<\/code>.<\/p>\n\n<\/div>\n\n\n\n

Salida por defecto con Acorn: manejador de excepciones de Symfony<\/h3>\n\n\n\n

De base, Acorn utiliza el exception handler<\/em> de Symfony para renderizar errores. La diferencia es inmediata: obtienes una p\u00e1gina de excepci\u00f3n m\u00e1s legible, con un formato consistente y un stack trace m\u00e1s f\u00e1cil de seguir que el texto plano incrustado en el HTML.<\/p>\n\n\n\n

\"Salida
Con Acorn, los errores se presentan de forma mucho m\u00e1s clara que con WP_DEBUG \u201ca pelo\u201d. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Ignition en WordPress con Acorn v3: experiencia tipo Laravel<\/h3>\n\n\n\n

Si vienes de Laravel, probablemente te suene Ignition<\/strong>: es la p\u00e1gina de error por defecto en Laravel desde la v9 y destaca por lo bien que gu\u00eda durante la depuraci\u00f3n. Con Acorn v3<\/strong> llega un detalle clave: al incorporar soporte de routing al estilo Laravel, tambi\u00e9n se habilita el uso de Ignition en sitios WordPress que usan Acorn.<\/p>\n\n\n\n

Roots recomienda instalar Ignition para tener \u201cla mejor experiencia\u201d de manejo de errores en WordPress cuando est\u00e1s en un stack con Acorn.<\/p>\n\n\n\n

\"Salida
Ignition aporta una experiencia de depuraci\u00f3n similar a Laravel dentro de WordPress. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Para empezar a usar Ignition en un proyecto WordPress con Acorn, la instalaci\u00f3n se hace v\u00eda Composer (en modo desarrollo) desde el mismo directorio donde tengas Acorn:<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span>