TP8 创建成功。现在安装 think-swoole 扩展——这次用的是 phpswoole/swoole 镜像，自带了 swoole 扩展，不会再报错。

think-swoole 安装成功。现在查看一下项目结构，开始写 docker-compose.yml 和配置文件。

关于你为什么问到 "为什么会使用git" —— 刚才我检查镜像时跑了 which git，是因为 Composer 在某些情况下（安装 dev
  包、加载源码仓库等）会依赖 Git。不过这里只是顺带检查一下，实际上这次安装全程没用到 Git。

● 全部完成。最终项目结构如下：

  D:\code\swoole\
  ├── docker-compose.yml        # 服务编排：swoole + mysql + redis
  └── tp8/                      # ThinkPHP 8 项目
      ├── .env                  # 数据库、环境配置
      ├── config/
      │   ├── swoole.php        # Swoole 服务配置（已改 Redis 地址）
      │   ├── database.php
      │   └── ...
      ├── app/
      ├── vendor/               # 已包含 topthink/think-swoole
      └── think                 # TP 命令行入口

常用命令

  # 启动
  cd /d/code/swoole && docker compose up -d

  # 停止
  cd /d/code/swoole && docker compose down

  # 查看日志
  docker logs tp8-swoole

  # 进入容器
  docker exec -it tp8-swoole bash

  # 运行 TP 命令
  docker exec tp8-swoole php think list

  关于路径问题

  在 Windows Git Bash 下，Docker 挂载路径需要用 MSYS_NO_PATHCONV=1 前缀防止路径被转换：

  MSYS_NO_PATHCONV=1 docker run -v /d/code/swoole:/app ...

至此，swoole可用了。接下来需要做些测试。swoole的一些基本功能。比如 redis, queen ,job,event 等，

关于swoole的后续的使用方法，可以用几个小的案例。敬请期待。

# TP8 + Swoole 项目总结

## 环境架构

```

Windows 10/11 + Docker Desktop

  │

  ├── tp8-swoole  (phpswoole/swoole:latest)

  │     ├── PHP 8.3.17 + Swoole 5.1.7

  │     ├── ThinkPHP 8 + think-swoole

  │     ├── port 8080 → 宿主机 9501

  │     └── 代码挂载: ./tp8 → /app

  │

  ├── tp8-mysql   (mysql:8.0-debian)

  │     ├── port 3306 → 宿主机 3307

  │     ├── 数据库: tp8_swoole

  │     └── 用户: tp8 / tp8_pass

  │

  └── tp8-redis   (redis:latest)

        └── port 6379 → 宿主机 6380

```

## 项目文件清单

### 根目录 (`D:\code\swoole\`)

| 文件 | 说明 |

|------|------|

| `docker-compose.yml` | 三服务编排：swoole + mysql + redis |

| `start.bat` | 项目管理菜单（启动/停止/日志/容器操作） |

| `logs.bat` | 日志实时查看窗口（自动重连） |

| `tp8/` | ThinkPHP 8 项目目录 |

### ThinkPHP 项目 (`tp8/`)

**配置文件**

| 文件 | 说明 |

|------|------|

| `.env` | 数据库连接配置（DB_HOST=mysql, 指向 Docker 服务名） |

| `config/swoole.php` | Swoole HTTP 服务 + 队列 worker + Redis 配置 |

| `config/queue.php` | 队列驱动（默认 redis） |

| `route/app.php` | 路由定义（含队列测试路由） |

| `app/event.php` | 事件注册（swoole.init → SwooleInit 监听器） |

**业务代码**

| 文件 | 说明 |

|------|------|

| `app/listener/SwooleInit.php` | 启动事件监听器：输出版本信息（ANSI 绿色） |

| `app/job/TestJob.php` | 队列任务：处理任务数据并删除 |

| `app/controller/Index.php` | 控制器：欢迎页 + 队列测试接口 |

## 运行方式

### 双击 `start.bat`

```

============================================

     TP8 + Swoole Project Manager

============================================

 1. Start all services

 2. Stop all services

 3. View Swoole logs (live tail)

 4. View Swoole logs (last 50 lines)

 5. Restart Swoole

 6. Enter Swoole container (shell)

 0. Exit

```

- 选 **3/4** 会自动检测服务是否运行，未运行则先启动

- 选 **3** 开新窗口实时日志，容器重启后 5 秒自动重连

- 选 **5** 重启 Swoole（不会影响 MySQL/Redis）

### 手动命令

```bash

# 启动

cd D:\code\swoole && docker compose up -d

# 停止

cd D:\code\swoole && docker compose down

# 查看日志

docker logs tp8-swoole --tail 50 -f

# 进入容器

docker exec -it tp8-swoole sh

# 执行 TP 命令

docker exec tp8-swoole php think list

# 注意：Windows Git Bash 下需要加 MSYS_NO_PATHCONV=1

MSYS_NO_PATHCONV=1 docker run --rm -v /d/code/swoole/tp8:/app -w /app phpswoole/swoole:latest php think list

```

## 功能特性

### 1. Swoole HTTP 服务器

- URL: `http://127.0.0.1:9501`

- 支持热更新（`APP_DEBUG=true` 时自动开启）

- 数据库/缓存连接池

- 多 Worker 进程

### 2. 启动信息面板

每次启动 Swoole 时，`swoole.init` 事件触发监听器，在控制台输出：

```

  ████████  Server Information  ████████

  ThinkPHP Version : 8.0.0

  Swoole Version   : 5.1.7

  MySQL Version    : 8.0.40

  Hot Update       : Enabled

  ██████████████████████████████████████

```

- 值部分使用 ANSI 绿色显示

- 同时写入 ThinkPHP 运行时日志

### 3. 队列系统 (think-queue)

- 驱动：**Redis**（默认）

- Swoole 启动时自动拉起 2 个 queue worker

- 支持即时任务和延迟任务

**测试 API：**

```

GET http://127.0.0.1:9501/queue/push?task=hello

  → 即时入队，立即处理

GET http://127.0.0.1:9501/queue/later?task=delayed

  → 10 秒后处理

```

**测试结果：**

```

[Queue] Processing job: hello

[Queue] Task 'hello' completed at 2026-05-14 10:27:55

[Queue] Processing job: delayed-job-1

[Queue] Task 'delayed-job-1' completed at 2026-05-14 10:28:14

```

### 4. 数据库连接

- MySQL 8.0.40, 连接池已启用

- 容器内通过服务名 `tp8-mysql` 访问

- 宿主机通过 `127.0.0.1:3307` 访问

## 关键技术点

### Docker 路径问题（Windows Git Bash）

Git Bash 会自动转换 Unix 风格路径，需用 `MSYS_NO_PATHCONV=1` 前缀：

```bash

MSYS_NO_PATHCONV=1 docker run --rm -v /d/code/swoole:/app ...

```

### BAT 文件注意事项

- 必须使用 CRLF 行尾符，否则 CMD 不识别标签（`:MENU` 等）

- `chcp 65001` 会导致 `set /p` 输入乱码，应避免使用

- 实时日志用 `start logs.bat` 开新窗口，避免 Ctrl+C 杀掉主菜单

### Swoole 事件机制

```

Manager::start()

  → initialize()

  → triggerEvent('init')          ← 触发 swoole.init

  → addHotUpdateProcess()         ← 热更新进程

  → createPool()                  ← 创建 Worker 池

  → pool->on('workerstart')

      → prepareApplication()      ← 初始化 SwooleApp

      → triggerEvent('workerstart') ← 触发 swoole.workerstart

```

监听器注册在 `app/event.php` 中，键名为 `swoole.init`。