phpswoole/swoole

Swoole Docker镜像

![]([] ![]([]

此镜像为通用目的构建，Git仓库中包含多种示例以帮助开发人员熟悉该镜像和Swoole。您可以从https://hub.docker.com/r/phpswoole/swoole%E8%8E%B7%E5%8F%96%E8%AF%A5%E9%95%9C%E5%83%8F%E3%80%82

目录

• 特性列表
• 如何使用此镜像
• 镜像变体
• 支持的标签
• 手动构建镜像
• 致谢

特性列表

• 内置脚本管理Swoole扩展和Supervisord程序
• 简化Docker环境中的启动脚本管理
• 支持在不同环境(包括ECS)直接运行PHP脚本和命令
• 单一根文件系统设计，仅需一个Docker COPY命令
• 预装Composer(4.5.8及之前版本使用v1，4.5.9及之后版本使用v2)
• 多架构支持
• 本地开发自动重载功能¹
• 代码调试支持
• 自4.8.12+和5.0.1+版本起默认包含pdo_mysql和Redis扩展²

注意

1. 自动重载功能仅支持非Alpine镜像
2. 可通过删除配置文件禁用默认扩展

如何使用此镜像

基于官方PHP镜像构建，基本用法与官方PHP镜像一致。

安装PHP扩展

使用内置辅助脚本安装扩展：

Dockerfile
# 安装MySQL扩展示例
FROM phpswoole/swoole:4.7-php7.4-alpine
RUN docker-php-ext-install mysqli pdo_mysql

# 安装Redis扩展示例
FROM phpswoole/swoole:4.7-php7.4-alpine
RUN set -ex \
    && pecl channel-update pecl.php.net \
    && yes no | pecl install redis-stable \
    && docker-php-ext-enable redis

禁用默认扩展

自4.8.12+和5.0.1+版本起，可通过以下方式禁用默认扩展：

Dockerfile
FROM phpswoole/swoole:4.8-alpine
RUN set -ex && \
    rm -f "$(php-config --ini-dir)/docker-php-ext-pdo_mysql.ini" && \
    rm -f "$(php-config --ini-dir)/docker-php-ext-redis.ini"

部署示例

非Alpine镜像示例：

bash
# 查看PHP模块
docker run --rm phpswoole/swoole php -m
# 查看Swoole信息
docker run --rm phpswoole/swoole php --ri swoole
# 查看Composer版本
docker run --rm phpswoole/swoole composer --version

使用docker-compose启动示例：

bash
# 启动第一个示例
./bin/example.sh start 00
# 停止示例
./bin/example.sh stop 00

示例分类

• 基础示例：自动重载、HTTP服务器、Nginx反向代理等
• 扩展管理：安装/配置PHP扩展、自定义扩展选项
• 进程管理：Supervisord服务配置、程序启停管理
• 调试工具：gdb、Valgrind、strace、Blackfire和Xdebug集成

镜像变体

提供三种类型的镜像：

1. 默认镜像

标签格式：latest, <swoole-version>, <swoole-version>-php<php-version> 基于php:cli镜像，使用Supervisord管理进程，预装Composer

自6.0.0起提供ZTS版本，标签后缀为-zts

2. 开发镜像

标签格式：latest-dev, <swoole-version>-dev 包含额外开发工具：gdb、git、lsof、strace、tcpdump、Valgrind和vim

自6.0.0起提供ZTS开发版本，标签后缀为-zts-dev

3. Alpine镜像

标签格式：latest-alpine, <swoole-version>-alpine 基于alpine镜像，工作目录为/var/www，预装Composer，无开发工具

支持的标签

版本化镜像

基于Swoole稳定版本构建，包括：

• Swoole 6.0：支持PHP 8.1-8.4，提供标准、开发、ZTS和Alpine版本
• Swoole 5.1：支持PHP 8.0-8.3，提供标准、开发和Alpine版本
• Swoole 5.0：支持PHP 8.0-8.2，提供标准、开发和Alpine版本
• Swoole 4.8：支持PHP 7.2-8.2，提供标准、开发和Alpine版本

夜间构建镜像

基于Swoole master分支每日构建，支持PHP 8.1-8.4各版本

手动构建镜像

1. 安装Composer依赖：composer update -n
2. 生成Dockerfile：./bin/generate-dockerfiles.php [版本号|nightly]
3. 构建镜像：

bash
docker build -t phpswoole/swoole:php8.2 -f dockerfiles/nightly/php8.2/cli/Dockerfile .
# 构建开发镜像
docker build --build-arg DEV_MODE=true -t phpswoole/swoole:php8.2-dev -f dockerfiles/nightly/php8.2/cli/Dockerfile .

致谢

• 实现借鉴了Demin在Glu Mobile的工作
• 感谢Blackfire提供免费开源订阅