idrunk/swoole

idrunk/swoole镜像说明

镜像概述

本镜像由Dce作者封装，基于Swoole官方PHP8.1 Alpine镜像构建，兼容Dce框架及普通Swoole/PHP CLI程序。镜像提供thin、normal、debug三个版本，满足不同开发场景需求。

核心功能

• thin版本：基础镜像，增装pdo_mysql、redis扩展，适合轻量Swoole应用部署。
• normal版本：在thin基础上增加gmp、gd、imagick扩展，支持图片处理、大数运算等场景。
• debug版本：集成Swoole官方推荐调试工具包（yasd、tcpdump、strace等），便于开发阶段的代码调试与性能分析。

使用场景

1. Dce框架项目的开发与生产部署。
2. 普通Swoole应用或PHP CLI程序的运行。
3. 开发阶段使用debug版本进行断点调试、网络抓包、进程分析等操作。

配置说明

yasd调试配置

yasd支持通过环境变量传递部分配置，未支持的配置可通过映射宿主机文件覆盖/usr/local/etc/php/conf.d/docker-php-ext-yasd.ini。配置对应关系如下：

yasd remote用法

1. 在PhpStorm中设置Xdebug监听端口为44444并启动监听。
2. 在PhpStorm的PHP->Servers中添加服务器，映射本地项目目录与容器内/app路径（建议命名为dce）。
3. 启动容器（替换<宿主机IP>和<项目目录>为实际值）：

bash
docker run --rm --privileged --name dce -it -e "DEBUG_HOST=<宿主机IP>" -v <项目目录>:/app -p <服务端口>:20461 idrunk/swoole:debug -e /app/dce websocket start

若服务器名非dce，需添加环境变量：-e PHP_IDE_CONFIG="serverName=<服务器名>"。

常用调试工具使用

tcpdump（网络抓包）

bash
docker exec -it dce tcpdump -i any tcp port 20461

strace（系统调用跟踪）

bash
docker exec -it dce strace -f -p <进程PID>

gdb（进程调试）

bash
docker exec -it dce gdb -p <进程PID>

zbacktrace（PHP栈跟踪）

bash
docker exec -it dce gdb -p <进程PID>
source /usr/src/php/.gdbinit
zbacktrace

lsof（进程文件描述符查看）

bash
docker exec -it dce lsof -p <进程PID>

perf（性能分析）

bash
docker exec -it dce perf top -p <进程PID>

部署示例

thin版本运行普通Swoole脚本

bash
docker run --rm -v /path/to/your/project:/app idrunk/swoole:thin php /app/your_swoole_script.php

normal版本运行带GD功能的应用

bash
docker run --rm -v /path/to/your/project:/app idrunk/swoole:normal php /app/your_gd_app.php