Ir al contenido principal

Solucionar problemas y depurar Blueprints

Cuando creas Blueprints, puedes encontrarte con problemas. Aquí tienes consejos y herramientas para ayudarte a depurarlos:

Revisa problemas comunes​

  • Requiere wp-load: para ejecutar una función PHP de WordPress usando el paso runPHP, tendrás que requerir wp-load.php. Por eso, el valor de la clave code debe empezar con "<?php require_once('wordpress/wp-load.php'); RESTO_DE_TU_CÓDIGO".

Problemas comunes y soluciones​

Blueprint no válido después de abrir un enlace​

Si Playground informa Invalid blueprint, lee el mensaje de error detallado. Incluye el error de análisis JSON subyacente cuando está disponible.

Si el mensaje dice que la entrada todavía contiene secuencias de escape %XX después de decodificarla, es probable que el fragmento de URL se haya codificado dos veces. Reconstruye el enlace a partir del objeto Blueprint original y codifícalo una sola vez con encodeURIComponent(JSON.stringify(blueprint)), o usa Base64. No codifiques un fragmento que ya esté codificado.

WP-CLI: error al establecer una conexión con la base de datos en sitios montados​

Al usar wp-cli con un sitio Playground montado (por ejemplo, mediante --mount-before-install), puedes encontrar un mensaje de "Error establishing a database connection". Esto ocurre porque WordPress Playground carga por defecto el plugin de integración de base de datos SQLite desde sus archivos internos, no desde el directorio montado, lo que significa que no se conserva para llamadas externas de wp-cli.

Para resolverlo, debes instalar y configurar explícitamente el plugin de integración de base de datos SQLite dentro de tu Blueprint.

Solución: añade los siguientes pasos a tu Blueprint:

{
	"plugins": ["sqlite-database-integration"]
}

Ejemplo de uso:

Para probarlo localmente, combina el Blueprint con tu comando de Playground CLI:

mkdir wordpress
# Ensure your blueprint with the above steps is saved as, for example, './blueprint.json'
npx @wp-playground/cli server --mount-before-install=wordpress:/wordpress --blueprint=./blueprint.json
cd wordpress
wp post list

Esto garantiza que el plugin SQLite se instale correctamente y se configure dentro de tu sitio WordPress montado, lo que permite que los comandos wp-cli funcionen correctamente.

Constructor de Blueprints​

Puedes usar un editor de Blueprints en el navegador para crear, validar y previsualizar tus Blueprints.

Precaución

El editor está en desarrollo y el Playground incrustado a veces no carga. Para solucionarlo, actualiza la página. Somos conscientes de ello y estamos trabajando para mejorar la experiencia.

Revisa el sistema de archivos y la base de datos​

Algunos pasos de Blueprint (como writeFile) modifican la estructura interna del sistema de archivos de la instancia de Playground, y otros (como runSql) modifican la base de datos interna de WordPress.

Para revisar la estructura final del sistema de archivos interno y la base de datos (después de aplicar los pasos del Blueprint), podemos usar algunos plugins de WordPress que proporcionan un gestor SQL y un explorador de archivos, como SQL Buddy y WPide (puedes verlos en acción desde https://playground.wordpress.net/?plugin=sql-buddy&plugin=wpide).

consejo

Hay varios métodos que podemos ejecutar desde la consola de cualquier instancia de WordPress Playground para inspeccionar sus partes internas. Están expuestos como parte del objeto window.playground (consulta Desarrolladores > API de JavaScript > Depuración y pruebas). Algunos ejemplos:

> await playground.isDir("/wordpress/wp-content/plugins")
true
> await playground.listFiles("/wordpress/wp-content/plugins")
(3) ['hello.php', 'index.php', 'WordPress-Importer-master']

La lista completa de métodos que podemos usar está disponible aquí.

Revisa errores en la consola del navegador​

Si tu Blueprint no se está ejecutando como esperas, abre las herramientas de desarrollo del navegador para comprobar si hay errores.

Para abrir las herramientas de desarrollo en Chrome, Firefox, Safari* y Edge: pulsa Ctrl + Shift + I en Windows/Linux o Cmd + Option + I en macOS.

precaución

Si aún no lo has hecho, activa el menú Desarrollo: ve a Safari > Configuración... > Avanzado y marca Mostrar funciones para desarrolladores web.

La ventana de herramientas de desarrollo te permite inspeccionar solicitudes de red, ver registros de consola, depurar JavaScript y examinar el DOM y los estilos CSS aplicados a tu página. Esto es clave para diagnosticar y corregir problemas con Blueprints.

Registra tus propios mensajes de error​

Puedes registrar tus propios mensajes de error con error_log mediante el paso runPHP (consulta el ejemplo de Blueprint y la demo en vivo) y revisarlos desde la opción "View Logs" o desde la consola del navegador.

Captura de errores de registro

información

Cuando descargas tu instancia de Playground como un zip mediante la opción "Download as zip", también descargas el archivo debug.log, que contiene todos los registros de tu instancia de Playground.

Pide ayuda​

La comunidad está aquí para ayudar. Si tienes preguntas o comentarios, abre un nuevo issue en este repositorio. Recuerda incluir los siguientes detalles:

  • El Blueprint que intentas ejecutar.
  • El mensaje de error que ves, si lo hay.
  • La salida completa de las herramientas de desarrollo del navegador.
  • Cualquier otra información relevante que pueda ayudarnos a entender el problema: sistema operativo, versión del navegador, etc.