openswoole/swoole

Open Swoole Docker镜像

镜像概述和主要用途

Open Swoole Docker镜像是为OpenSwoole提供的官方Docker镜像，旨在简化OpenSwoole应用的部署与运行。该镜像提供三种变体，分别针对生产环境、开发调试等不同场景，基于PHP CLI环境构建，并预装必要工具以满足多样化需求。

核心功能和特性

镜像变体

Open Swoole Docker镜像提供三种变体，每种设计用于特定使用场景：

1. 标准变体（latest, <openswoole-version>, <openswoole-version>-php<php-version>）

标签格式示例：

• openswoole/swoole:latest
• openswoole/swoole:4.12.1
• openswoole/swoole:4.12.1-php8.2

特性：

• 基于php:cli镜像构建，进行少量适配调整
• 使用Supervisord管理启动进程，确保服务稳定运行
• 预装Composer，便于依赖管理

2. 开发变体（latest-dev, <swoole-version>-dev, <swoole-version>-php<php-version>-dev）

标签格式示例：

• openswoole/swoole:latest-dev
• openswoole/swoole:4.11-dev
• openswoole/swoole:4.11-php8.1-dev
• openswoole/swoole:4.11.1-php8.1-dev

特性：

• 与标准变体基础特性一致
• 额外集成测试、调试和监控工具，包括：gdb、git、lsof、strace、tcpdump、Valgrind、vim
• 适用于开发、调试和性能分析场景

3. Alpine变体（latest-alpine, <openswoole-version>-alpine, <openswoole-version>-php<php-version>-alpine）

标签格式示例：

• openswoole/swoole:latest-alpine
• openswoole/swoole:4.11-alpine
• openswoole/swoole:4.11-php8.1-alpine
• openswoole/swoole:4.11.1-php8.1-alpine

特性：

• 基于Alpine Linux构建，体积更小，资源占用更低
• 安全性和性能优化，推荐用于生产环境

使用场景和适用范围

• 生产环境：优先选择Alpine变体，其轻量级特性适合生产部署，资源占用低且稳定性高。
• 开发与调试：选择开发变体（-dev标签），通过预装的gdb、strace等工具支持代码调试、性能分析和问题排查。
• 通用测试：标准变体适用于日常开发、测试和演示场景，平衡功能完整性与资源占用。

使用方法和配置说明

基础使用命令

运行标准变体

bash
# 运行最新版标准镜像
docker run -it --rm openswoole/swoole:latest

# 指定OpenSwoole版本和PHP版本
docker run -it --rm openswoole/swoole:4.12.1-php8.2

运行开发变体

bash
# 运行最新版开发镜像
docker run -it --rm openswoole/swoole:latest-dev

# 指定版本和PHP版本
docker run -it --rm openswoole/swoole:4.11-php8.1-dev

运行Alpine变体（生产环境推荐）

bash
# 运行最新版Alpine镜像
docker run -it --rm openswoole/swoole:latest-alpine

# 指定版本和PHP版本
docker run -it --rm openswoole/swoole:4.11.1-php8.1-alpine

关键特性说明

• 进程管理：标准和开发变体使用Supervisord管理启动进程，确保应用进程稳定运行。
• 依赖管理：所有变体预装Composer，可直接执行composer install管理项目依赖。
• 版本控制：通过标签精确指定OpenSwoole版本（如4.12.1）和PHP版本（如php8.2），确保环境一致性。
• 工具集成：开发变体额外包含gdb（调试）、strace（系统调用跟踪）、tcpdump（网络抓包）等工具，支持深度调试。

使用场景和适用范围

• 生产环境：推荐使用Alpine变体，其基于Alpine Linux，体积小、资源占用低，安全性更高。
• 开发调试：选择开发变体，利用预装的调试工具进行代码测试、问题排查和性能分析。
• 通用部署：标准变体适用于日常开发、演示和非关键生产场景，平衡功能与资源需求。