Zum Inhalt springen

Erste Schritte

Als Markdown anzeigen Auf GitHub bearbeiten Dokumentation zu 7a44bd6

Voraussetzungen

  • PHP 8.2+
  • WordPress 6.4+
  • MySQL oder MariaDB über die normale WordPress-Datenbankverbindung
  • ein beschreibbares wp-config.php bei Aktivierung des Plugins

Installation

Installiere Rudel mit Composer und aktiviere es wie ein normales WordPress-Plugin.

Shell
composer require rudel/rudel
wp plugin activate rudel

Composer installiert Rudel unter vendor/rudel/rudel, sofern dein Projekt Plugins von WordPress nicht nach wp-content/plugins umleitet (zum Beispiel mit composer/installers). Das Plugin muss sich im Plugin-Verzeichnis befinden, damit wp plugin activate rudel es findet.

Was die Aktivierung bewirkt

Bei der Aktivierung werden die Tabellen von Rudel erstellt, das stündliche Bereinigungsereignis geplant und eine Bootstrap-Zeile in wp-config.php eingefügt, direkt über der Zeile, die wp-settings.php lädt. So kann Rudel eine Sandbox auswählen, bevor WordPress vollständig geladen ist. Zuerst erstellt Rudel eine Sicherungskopie namens wp-config.php.rudel-backup-{timestamp}.

Es gibt keinen separaten Installationsbefehl. Wenn wp-config.php nicht beschreibbar ist, schlägt die Aktivierung fehl. Bei der Deaktivierung werden die Zeile und das geplante Ereignis entfernt.

Laufzeitstatus prüfen:

Shell
wp rudel status

Bootstrap installed sollte yes anzeigen.

Eine Sandbox erstellen

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

Rudel gibt die generierte Sandbox-ID aus, zum Beispiel alpha-3be7. Es klont die Tabellen des Hosts WordPress mit einem sandbox-spezifischen Tabellenpräfix, kopiert das Theme in das Sandbox-Verzeichnis und speichert den Datensatz in der Datenbank des Hosts WordPress. Die folgenden Beispiele verwenden alpha-3be7; verwende die ID, die dein Befehl ausgegeben hat.

WP-CLI in einer Sandbox verwenden

Shell
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname

Ohne RUDEL_ENVIRONMENT kommuniziert WP-CLI mit dem Host.

HTTP in eine Sandbox leiten

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

Setze für eine Browsersitzung ein rudel_environment-Cookie mit der Sandbox-ID. Rudel liest das Cookie, setzt oder löscht es aber nie. Lösche das Cookie, um zum Host zurückzukehren.

Die Sandbox läuft auf dem Host URL. Ohne Header oder Cookie stellt dasselbe URL den Host bereit.

Nächste Schritte