Saltar al contenido

Primeros pasos

Ver como Markdown Editar en GitHub Documentación de 7a44bd6

Requisitos

  • PHP 8.2+
  • WordPress 6.4+
  • MySQL o MariaDB mediante la conexión normal a la base de datos de WordPress
  • un wp-config.php con permisos de escritura al activar el plugin

Instalación

Instale Rudel con Composer y actívelo como un plugin normal de WordPress.

Shell
composer require rudel/rudel
wp plugin activate rudel

Composer instala Rudel en vendor/rudel/rudel, salvo que su proyecto asigne los plugins de WordPress a wp-content/plugins (por ejemplo, con composer/installers). El plugin debe estar en el directorio de plugins para que wp plugin activate rudel lo encuentre.

Qué hace la activación

La activación crea las tablas de Rudel, programa el evento de limpieza cada hora y añade una línea de inicialización a wp-config.php, justo antes de la línea que carga wp-settings.php. Esa línea permite que Rudel seleccione un entorno aislado antes de que termine de cargarse WordPress. Primero, Rudel escribe una copia de seguridad llamada wp-config.php.rudel-backup-{timestamp}.

No hay un comando de instalación independiente. Si wp-config.php no permite escritura, la activación falla. La desactivación elimina la línea y el evento programado.

Compruebe el estado del entorno de ejecución:

Shell
wp rudel status

Bootstrap installed debería indicar yes.

Crear un entorno aislado

Shell
wp rudel create --name=alpha --theme=twentytwentyfour

Rudel muestra el ID generado del entorno aislado, por ejemplo, alpha-3be7. Clona las tablas de WordPress del sitio anfitrión con un prefijo de tablas propio, copia el tema al directorio del entorno aislado y guarda el registro en la base de datos de WordPress del sitio anfitrión. En los ejemplos siguientes se usa alpha-3be7; utilice el ID que mostró su comando.

Usar WP-CLI dentro de un entorno aislado

Shell
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname

Sin RUDEL_ENVIRONMENT, WP-CLI se comunica con el sitio anfitrión.

Dirigir HTTP a un entorno aislado

Shell
curl -H 'X-Rudel-Environment: alpha-3be7' http://localhost:8000/

En una sesión del navegador, establezca una cookie de rudel_environment con el ID del entorno aislado. Rudel lee la cookie, pero nunca la establece ni la borra. Elimine la cookie para volver al sitio anfitrión.

El entorno aislado se ejecuta en el URL del sitio anfitrión. Sin el encabezado o la cookie, el mismo URL sirve el sitio anfitrión.

Pasos siguientes