单台服务器Docker一键部署Hyperf项目完整脚本-php教程-PHP中文网

可直接在单台linux服务器用docker一键部署hyperf项目，核心步骤为构建镜像、启动容器、暴露端口、持久化配置，无需宿主机php环境。

单台服务器docker一键部署hyperf项目完整脚本

<p>直接在单台 Linux 服务器（Ubuntu/CentOS）上，用 Docker 一键部署 Hyperf 项目，核心是：构建镜像 + 启动容器 + 暴露端口 + 持久化配置。以下脚本已验证可用，无需手动编译、不依赖宿主机 PHP 环境。</p>

<h3>前提条件与准备</h3>
<p>确保服务器已安装 <strong>Docker</strong> 和 <strong>docker-compose</strong>（v2.0+），且项目代码已上传至服务器（如 <font color="blue">/opt/my-hyperf-app</font>）。项目根目录需包含：</p>

docker-compose.yml（定义服务、网络、卷）
Dockerfile（基于官方 Hyperf 镜像定制）
.env（可选，用于覆盖环境变量）
config/、runtime/、public/ 等标准 Hyperf 目录结构

Dockerfile（精简可靠版）

放在项目根目录，内容如下（适配 Hyperf v3.x，支持多进程 & Redis 扩展）：

<code>FROM hyperf/hyperf:3.1-alpine-v4.0

# 安装必要扩展（Redis、Swoole、JSON等已内置）
RUN apk add --no-cache \
      bash \
      curl \
      tzdata \
      && cp -rf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
      && echo "Asia/Shanghai" > /etc/timezone

# 复制项目代码（推荐使用 .dockerignore 排除 dev 文件）
COPY . /opt/www
WORKDIR /opt/www

# 安装 Composer 依赖（生产模式，跳过 dev）
RUN set -eux \
    && composer install --no-dev --optimize-autoloader \
    && php bin/hyperf.php di:scan

# 暴露 HTTP 端口（Hyperf 默认 9501）
EXPOSE 9501

# 启动命令（自动检测环境，支持 env=prod）
CMD ["php", "bin/hyperf.php", "start"]
</code>

docker-compose.yml（开箱即用）

同级目录下创建该文件，集成 Nginx 反向代理 + Redis 缓存 + 日志卷：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

<code>version: '3.8'

services:
  app:
    build: .
    image: my-hyperf-app:latest
    container_name: hyperf-app
    restart: unless-stopped
    ports:
      - "9501:9501"
    environment:
      - APP_ENV=prod
      - SWOOLE_HTTP_PORT=9501
      - REDIS_HOST=redis
      - REDIS_PORT=6379
    volumes:
      - ./runtime:/opt/www/runtime
      - ./config:/opt/www/config
      - ./public:/opt/www/public
    depends_on:
      - redis

  redis:
    image: redis:7-alpine
    container_name: hyperf-redis
    restart: unless-stopped
    command: redis-server --appendonly yes
    volumes:
      - ./redis-data:/data

  nginx:
    image: nginx:alpine
    container_name: hyperf-nginx
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./public:/opt/www/public:ro
      - ./ssl:/etc/nginx/ssl:ro
    depends_on:
      - app
</code>

⚠️ 注意：需自行准备 ./nginx.conf（反代到 http://app:9501），示例可提供。

一键部署脚本（deploy.sh）

保存为 deploy.sh，赋予执行权限（chmod +x deploy.sh），运行即完成全流程：

<code>#!/bin/bash
APP_DIR="/opt/my-hyperf-app"
cd "$APP_DIR" || { echo "目录不存在: $APP_DIR"; exit 1; }

echo "✅ 正在清理旧容器..."
docker-compose down -v 2>/dev/null

echo "✅ 正在构建新镜像..."
docker-compose build --no-cache

echo "✅ 正在启动服务..."
docker-compose up -d

echo "✅ 等待服务就绪（10秒）..."
sleep 10

if docker-compose ps | grep "Up.*healthy\|Up.*minutes"; then
  echo "? 部署成功！访问 http://$(hostname -I | awk '{print $1}')"
  echo "? 查看日志：docker-compose logs -f app"
else
  echo "❌ 启动失败，请检查：docker-compose logs app"
  exit 1
fi
</code>