# 安装与配置

::: tip 我也不知道
2026 年了，遇事不决，请找 AI。
:::

---

## 环境依赖

- PHP：必须，世界上最好的语言。
- MySQL：必须，我的[发音](https://dev.mysql.com/doc/refman/8.4/en/what-is-mysql.html)是 `My S-Q-L`，不是 `My sequel`，更不是 `My 色扣`。
- Redis：可选，仅在需要使用 Redis 作为缓存、会话或队列驱动时使用。
- Nginx：可选，生产部署常用，本地可直接使用 `php artisan serve`。
- Composer：部署使用，安装 PHP 依赖。
- Npm：部署使用，构建前端资源。

> The official way to pronounce “MySQL” is “My Ess Que Ell” (not “my sequel”), but we do not mind if you pronounce it as “my sequel” or in some other localized way.

---

## 部署步骤

进入项目的根目录：

```bash
cd bookstack-basic
```

安装 PHP 依赖：

```bash
composer install
```

安装前端依赖：

```bash
npm install
```

构建静态资源：

```bash
npm run build
```

复制环境配置：

```bash
cp .env.example .env
```

修改 `.env`，确认以下配置：

```env
APP_URL=http://localhost:8402

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bookstack
DB_USERNAME=root
DB_PASSWORD=
```

如果你要使用 Redis，可额外设置：

```env
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_SERVERS=127.0.0.1:6379:0
```

生成应用密钥：

```bash
php artisan key:generate
```

执行数据库迁移：

```bash
php artisan migrate
```

导入示例数据（可选）：

```bash
php artisan bookstack:import-demo-content
```

运行项目，直接启动内置服务：

```bash
php artisan serve --host=127.0.0.1 --port=8402
```

访问：

```text
http://127.0.0.1:8402
```

---

## 账号密码

```bash [账号]
admin@admin.com
```

```bash [密码]
password
```