Ga naar de inhoud

Aan de slag

Bekijken als Markdown Bewerken op GitHub Documentatie op 7a44bd6

Vereisten

  • PHP 8.2+
  • WordPress 6.4+
  • MySQL of MariaDB via de normale WordPress-databaseverbinding
  • een beschrijfbare wp-config.php wanneer de plug-in wordt geactiveerd

Installeren

Installeer Rudel met Composer en activeer het zoals een normale WordPress-plug-in.

Shell
composer require rudel/rudel
wp plugin activate rudel

Composer installeert Rudel in vendor/rudel/rudel, tenzij je project WordPress-plug-ins aan wp-content/plugins koppelt (bijvoorbeeld met composer/installers). De plug-in moet in de plug-insmap staan zodat wp plugin activate rudel deze kan vinden.

Wat activering doet

Activering maakt de tabellen van Rudel aan, plant de uurlijkse opschoningsgebeurtenis in en voegt één bootstrapregel toe aan wp-config.php, direct boven de regel die wp-settings.php laadt. Daardoor kan Rudel een sandbox selecteren voordat WordPress klaar is met laden. Rudel maakt eerst een reservekopie met de naam wp-config.php.rudel-backup-{timestamp}.

Er is geen aparte installatieopdracht. Als wp-config.php niet beschrijfbaar is, mislukt de activering. Bij deactivering worden de regel en de geplande gebeurtenis verwijderd.

Controleer de runtimestatus:

Shell
wp rudel status

Bootstrap installed moet yes aangeven.

Een sandbox aanmaken

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

Rudel toont de gegenereerde sandbox-ID, bijvoorbeeld alpha-3be7. De opdracht kloont de host-WordPress-tabellen naar een tabelprefix voor de sandbox, kopieert het thema naar de sandboxmap en slaat de record op in de host-WordPress-database. In de voorbeelden hieronder wordt alpha-3be7 gebruikt; gebruik de ID die je opdracht heeft getoond.

WP-CLI in een sandbox gebruiken

Shell
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname

Zonder RUDEL_ENVIRONMENT maakt WP-CLI verbinding met de host.

HTTP naar een sandbox routeren

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

Stel voor een browsersessie een rudel_environment-cookie in met de sandbox-ID. Rudel leest de cookie, maar stelt deze nooit in of wist deze nooit. Verwijder de cookie om terug te keren naar de host.

De sandbox draait op de host-URL. Zonder de header of cookie serveert dezelfde URL de host.

Volgende stappen