# Začetek

## Zahteve

- PHP 8.2+
- WordPress 6.4+
- MySQL ali MariaDB prek običajne povezave z zbirko podatkov WordPress
- zapisljiv `wp-config.php` ob aktivaciji vtičnika

## Namestitev

Namestite Rudel z Composer in ga aktivirajte kot običajen vtičnik za WordPress.

```bash
composer require rudel/rudel
wp plugin activate rudel
```

Composer namesti Rudel v `vendor/rudel/rudel`, razen če vaš projekt preslika vtičnike WordPress v `wp-content/plugins` (na primer z `composer/installers`). Vtičnik mora biti v imeniku vtičnikov, da ga `wp plugin activate rudel` lahko najde.

## Kaj naredi aktivacija

Aktivacija ustvari tabele za Rudel, načrtuje urno čiščenje in doda vrstico za zagon v `wp-config.php`, neposredno nad vrstico, ki naloži `wp-settings.php`. Ta vrstica omogoča, da Rudel izbere peskovnik, preden se WordPress v celoti naloži. Rudel najprej ustvari varnostno kopijo z imenom `wp-config.php.rudel-backup-{timestamp}`.

Ločenega ukaza za namestitev ni. Če `wp-config.php` ni zapisljiv, aktivacija ne uspe. Ob deaktivaciji se vrstica in načrtovani dogodek odstranita.

Preverite stanje izvajalnega okolja:

```bash
wp rudel status
```

`Bootstrap installed` mora prikazovati `yes`.

## Ustvarjanje peskovnika

```bash
wp rudel create --name=alpha --theme=twentytwentyfour
```

Rudel izpiše ustvarjeni ID peskovnika, na primer `alpha-3be7`. Klonira tabele gostiteljevega okolja WordPress pod predpono tabel, značilno za peskovnik, kopira temo v imenik peskovnika in shrani zapis v gostiteljsko zbirko podatkov WordPress. Spodnji primeri uporabljajo `alpha-3be7`; uporabite ID, ki ga je izpisal vaš ukaz.

## Uporaba WP-CLI znotraj peskovnika

```bash
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname
```

Brez `RUDEL_ENVIRONMENT` se WP-CLI poveže z gostiteljem.

## Usmerjanje HTTP v peskovnik

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

Za sejo v brskalniku nastavite piškotek `rudel_environment` z ID-jem peskovnika. Rudel prebere piškotek, vendar ga nikoli ne nastavi ali izbriše. Če se želite vrniti na gostitelja, izbrišite piškotek.

Peskovnik deluje na gostiteljevem okolju URL. Brez glave ali piškotka isti URL streže gostitelja.

## Naslednji koraki

- [Ustvarjanje okolij](https://rudel.inline0.dev/sl/docs/environments/creating)
- [Upravljanje okolij](https://rudel.inline0.dev/sl/docs/environments/managing)
- [Izolacija](https://rudel.inline0.dev/sl/docs/environments/isolation)
- [CLI](https://rudel.inline0.dev/sl/docs/cli)