# Първи стъпки

## Изисквания

- PHP 8.2+
- WordPress 6.4+
- MySQL или MariaDB чрез обичайната връзка към базата данни на WordPress
- директория `wp-config.php` с права за запис при активиране на добавката

## Инсталиране

Инсталирайте Rudel с Composer и го активирайте като обикновена добавка на WordPress.

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

Composer инсталира Rudel в `vendor/rudel/rudel`, освен ако проектът ви не съпоставя добавките на WordPress с `wp-content/plugins` (например чрез `composer/installers`). Добавката трябва да е в директорията с добавки, за да я открие `wp plugin activate rudel`.

## Какво прави активирането

Активирането създава таблиците на Rudel, планира почасовото събитие за почистване и добавя ред за bootstrap в `wp-config.php` непосредствено над реда, който зарежда `wp-settings.php`. Този ред позволява на Rudel да избере изолирана среда преди WordPress да завърши зареждането. Първо Rudel записва резервно копие с име `wp-config.php.rudel-backup-{timestamp}`.

Няма отделна команда за инсталиране. Ако в `wp-config.php` няма права за запис, активирането е неуспешно. Деактивирането премахва реда и планираното събитие.

Проверете състоянието по време на изпълнение:

```bash
wp rudel status
```

`Bootstrap installed` трябва да показва `yes`.

## Създаване на изолирана среда

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

Rudel извежда генерирания идентификатор на изолираната среда, например `alpha-3be7`. Клонира таблиците на хоста WordPress с префикс за конкретната изолирана среда, копира темата в директорията на изолираната среда и съхранява записа в хостовата база данни WordPress. Примерите по-долу използват `alpha-3be7`; използвайте идентификатора, изведен от командата ви.

## Използване на WP-CLI в изолирана среда

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

Без `RUDEL_ENVIRONMENT` WP-CLI се свързва с хоста.

## Насочване на HTTP към изолирана среда

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

За браузърна сесия задайте бисквитка `rudel_environment` с идентификатора на изолираната среда. Rudel чете бисквитката, но никога не я задава или изчиства. Изтрийте бисквитката, за да се върнете към хоста.

Изолираната среда работи на хоста URL. Без заглавката или бисквитката същият URL обслужва хоста.

## Следващи стъпки

- [Създаване на среди](https://rudel.inline0.dev/bg/docs/environments/creating)
- [Управление на среди](https://rudel.inline0.dev/bg/docs/environments/managing)
- [Изолация](https://rudel.inline0.dev/bg/docs/environments/isolation)
- [CLI](https://rudel.inline0.dev/bg/docs/cli)