# Laravel Octane 安装文档

## 概述

本文档记录了在知识库系统中安装和配置 Laravel Octane 的过程。Laravel Octane 通过 Swoole 提供高性能的 PHP 应用服务器。

## 安装步骤

### 1. 安装 Laravel Octane 包

```bash
composer require laravel/octane
```

### 2. 发布配置文件

```bash
php artisan octane:install --server=swoole
```

### 3. 环境变量配置

在 `.env` 文件中添加以下 Swoole 相关配置：

```bash
# Octane/Swoole 配置
OCTANE_SERVER=swoole
OCTANE_HOST=0.0.0.0
OCTANE_PORT=8000
OCTANE_WORKERS=4
OCTANE_TASK_WORKERS=2
OCTANE_MAX_REQUESTS=500
OCTANE_WATCH=false
```

### 4. 配置文件更新

- `config/octane.php`: 默认服务器设置为 `swoole`
- `composer.json`: 添加了 `dev-octane` 脚本支持

## 验证安装

### 检查配置

```bash
php artisan config:show octane.server
```

应该显示: `swoole`

### 检查命令可用性

```bash
php artisan octane:status
```

应该显示: `Octane server is not running.`

### 运行测试

```bash
php artisan test tests/Feature/OctaneInstallationTest.php
```

## 使用方法

### 启动 Octane 服务器

```bash
php artisan octane:start
```

### 带监听文件变化启动

```bash
php artisan octane:start --watch
```

### 使用 Composer 脚本启动开发环境

```bash
composer run dev-octane
```

### 停止服务器

```bash
php artisan octane:stop
```

### 重启服务器

```bash
php artisan octane:restart
```

## 注意事项

1. **Swoole 扩展**: 在生产环境中需要安装 Swoole PHP 扩展
2. **内存驻留**: 应用会保持在内存中，需要注意内存泄漏
3. **全局变量**: 避免使用全局变量和静态变量
4. **配置缓存**: 建议在生产环境中使用配置缓存

## 下一步

- 更新 Docker 配置以支持 Swoole
- 配置生产环境部署脚本
- 进行性能测试和优化