# 快速入门

## 要求

- PHP 8.2+
- WordPress 6.4+
- MySQL或MariaDB，通过常规WordPress数据库连接
- 插件激活时，`wp-config.php`必须可写

## 安装

使用Composer安装Rudel，然后像普通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的表、安排每小时清理事件，并在`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会输出生成的沙盒 ID，例如`alpha-3be7`。它会将主机WordPress表克隆到专属表前缀下，将主题复制到沙盒目录，并在主机WordPress数据库中存储记录。以下示例使用`alpha-3be7`；请改用命令输出的 ID。

## 在沙盒中使用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/
```

对于浏览器会话，请设置一个值为沙盒 ID 的`rudel_environment`Cookie。Rudel会读取 Cookie，但不会设置或清除它。删除 Cookie 即可返回主机。

沙盒运行在主机URL上。没有请求头或 Cookie 时，同一个URL会提供主机内容。

## 后续步骤

- [创建环境](https://rudel.inline0.dev/zh/docs/environments/creating)
- [管理环境](https://rudel.inline0.dev/zh/docs/environments/managing)
- [隔离](https://rudel.inline0.dev/zh/docs/environments/isolation)
- [CLI](https://rudel.inline0.dev/zh/docs/cli)