webman 官方支持 Docker 一键部署指南

概述

Webman 是一款基于 Workerman 构建的超高性能可扩展 PHP 框架，集成了HTTP、WebSocket、TCP、UDP等多种模块。通过常驻内存、协程、连接池等先进技术，Webman不仅突破了传统PHP的性能瓶颈，还极大地扩展了其应用场景。

官方从 2.0 版本起正式集成 Docker 支持，实现真正的一键部署。本文将详细介绍 webman 的 Docker 一键部署流程，包括环境准备、操作步骤及常见问题解决，帮助开发者快速上手，实现从开发到生产的无缝过渡。

环境准备

1.1 安装 Docker 和 Docker Compose

Docker 是容器化技术的核心，webman 部署依赖其运行时环境。以下为常见操作系统的安装指南（基于官方文档，适用于 2025 年最新版本）。

Linux（CentOS/Ubuntu 示例）

1. 1. 更新系统包：

sudo yum update -y  # CentOS
# 或
sudo apt update && sudo apt upgrade -y  # Ubuntu

1. 2. 安装 Docker：

sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y  # CentOS
# 或
sudo apt install docker.io -y  # Ubuntu

1. 3. 启动并启用 Docker 服务：

sudo systemctl start docker
sudo systemctl enable docker

1. 4. 验证安装：

sudo docker --version
docker compose version

添加用户到 docker 组避免 sudo：sudo usermod -aG docker $USER，然后重启终端。

macOS

1. 1. 下载 Docker Desktop 从 https://www.docker.com/products/docker-desktop。
2. 2. 安装并启动应用，授予权限。
3. 3. 验证：终端执行 docker --version。

Windows

1. 1. 下载 Docker Desktop 从 https://www.docker.com/products/docker-desktop。
2. 2. 安装时启用 WSL 2（若未配置）。
3. 3. 启动应用，验证：PowerShell 执行 docker --version。

注意：确保 Docker Compose v2+ 已集成（命令为 docker compose）。

1.2 安装 Composer（可选，本地开发用）

若需本地创建项目：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

项目初始化

1. 1. 创建 webman 项目：

composer create-project workerman/webman webman-docker-demo
cd webman-docker-demo

这将生成标准项目结构，包括 docker-compose.yml 文件（webman 官方预置）。

1. 2. 检查环境兼容： 执行 php start.php check，确保无禁用函数（如 pcntl、posix）。若有问题，启用对应扩展。

一键部署操作

webman 的 Docker 支持基于 docker-compose.yml，默认配置 PHP 服务、端口 8787 等。一键命令即可拉取镜像、构建并启动。

3.1 调试模式部署（开发测试）

docker compose up

• • 拉取 webman 镜像（基于 PHP 8.1+）。
• • 控制台输出日志，便于调试。
• • 访问 http://localhost:8787 验证欢迎页面。

3.2 生产模式部署（后台运行）

docker compose up -d

• • 服务 detached 运行，终端可关闭。
• • 查看日志：docker compose logs -f。
• • 停止服务：docker compose down。

3.3 自定义配置

编辑 docker-compose.yml： 示例添加 MySQL 服务：

services:
  webman:
    image: workerman/webman:latest
    ports:
      - "8787:8787"
    volumes:
      - .:/app
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
    ports:
      - "3306:3306"

重新运行 docker compose up -d 生效。

3.4 运行结果

在浏览器中访问：

http://<服务器IP>:8787

即可打开 webman 默认首页