README

简介

将 docker 用于 webman 的开发和生产部署

镜像地址和 tag

krisss/docker-webman:7.4-cli-alpine ⚠️ 风险版本
krisss/docker-webman:8.0-cli-alpine ⚠️ 风险版本
krisss/docker-webman:8.1-cli-alpine ⚠️ 风险版本
krisss/docker-webman:8.2-cli-alpine
krisss/docker-webman:8.3-cli-alpine
krisss/docker-webman:8.4-cli-alpine
krisss/docker-webman:8.5-cli-alpine

此镜像会通过 github actions 动态更新 php 的小版本，镜像 tag 名不变

2.3.0 之后增加类似 7.4-cli-alpine-v2.3.0 形式的镜像版本，用于固定一个在发布版本时当前镜像中的各个组件版本（求稳可以用这种版本的镜像）

⚠️ 7.4 / 8.0 / 8.1 为风险版本：2026-10-21 PHP 官方修复了两个可被未授权远程利用的严重漏洞（CVE-2026-109618、CVE-2026-109619，CVSS 9.2），修复版本为 8.2.35 / 8.3.36 / 8.4.27 / 8.5.12 及以上。这三个大版本已停止官方维护（EOL），不会再获得修复，对应镜像将长期停留在含漏洞的 PHP 版本，仅建议遗留项目临时兼容使用，请尽快升级到 8.2 及以上版本。

镜像中的组件

php: extension 包含：bcmath、event、gd、mysqli、pdo_mysql、opcache、pcntl、redis、sockets、zip
composer
install-php-extensions
supervisor

安装

composer require webman-tech/docker

会在项目根目录下提供 Dockerfile 用于构建镜像，提供 docker-compose.yml 用于开发

使用

当开发环境使用：目前代码未建立

启动镜像

docker run --rm --name webman \
 -v /local/workspace:/app \
 -p 8787:8787 \
 -it \
 --privileged -u root \
 --entrypoint /bin/sh \
 krisss/docker-webman:7.4-cli-alpine

创建项目

composer create-project workerman/webman

启动项目

cd webman
php start.php start

访问 http://localhost:8787 即可

当开发环境使用：已有 webman 代码

在项目下自建 docker-compose.yml，参考例子如下：

version: "3.7"

services:
  webman:
    image: krisss/docker-webman:${DOCKER_WEBMAN_VERSION:-7.4-cli-alpine}
    ports:
      - "${DOCKER_WEBMAN_PORT:-8787}:8787"
    volumes:
      - .:/app

启动：

docker-compose up

访问 http://localhost:8787 即可

打包项目成镜像

在项目下自建 Dockerfile，参考例子如下：

ARG WEBMAN_DOCKER_VERSION=7.4-cli-alpine

# https://github.com/krissss/docker-webman
FROM krisss/docker-webman:$WEBMAN_DOCKER_VERSION

# 增加额外的扩展
#RUN install-php-extensions imagick

# 设置配置文件
# 自定义 php 配置文件，如果需要的话
# 覆盖镜像自带的
#COPY environments/docker/php.ini "$PHP_INI_DIR/conf.d/app.ini"
# 扩展额外的
#COPY environments/docker/my_php.ini "$PHP_INI_DIR/conf.d/my_php.ini"
# 自定义 supervisor 配置，如果需要的话
# 覆盖镜像自带的
#COPY environments/docker/supervisord.conf /etc/supervisor/supervisord.conf
# 扩展额外的
#COPY environments/docker/my_supervisord.conf /etc/supervisor/conf.d/my_supervisord.conf

# 预先加载 Composer 包依赖，优化 Docker 构建镜像的速度
COPY ./composer.json /app/
COPY ./composer.lock /app/
RUN composer install --no-interaction --no-dev --no-autoloader --no-scripts

# 复制项目代码
COPY . /app

# 执行 Composer 自动加载和相关脚本
RUN composer install --no-interaction --no-dev && composer dump-autoload

编译：

docker build -t {image-name} .

运行：

docker run --rm -p 8787:8787 {image-name}

访问 http://localhost:8787 即可

For Developer

修改 Dockerfile 后测试方式：

新建 .env 文件，其中配置 docker-compose.yml 中的 env 变量
执行build：docker-compose build webman
本机测试：docker run --rm -it {ImageName}:{ImageTag} /bin/sh

手动触发镜像构建

除每周定时构建和打 v*.*.* tag 自动构建外，支持在 GitHub 上手动触发：

进入仓库 Actions → Build Docker Image → Run workflow
选择要构建的 PHP 版本（all 为全部版本，也可单独选择某个版本）
构建并推送到 Docker Hub，tag 规则与定时构建一致

PHP 官方发布安全更新后，可手动触发以及时获取修复了新版本的镜像。

kriss / webman-docker

Package info

Security

Statistics

README

简介

镜像地址和 tag

镜像中的组件

安装

使用

当开发环境使用：目前代码未建立

当开发环境使用：已有 webman 代码

打包项目成镜像

For Developer

手动触发镜像构建