可直接在单台Linux服务器用Docker一键部署Hyperf项目，核心步骤为构建镜像、启动容器、暴露端口、持久化配置，无需宿主机PHP环境。
Dolphindb Docker
自动化 DolphinDB Docker 部署，支持自动架构检测（ARM64/x86_64），智能内存分配（50% 规则）以及完整数据持久化。
下载
<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>
<ul>
<li><strong>docker-compose.yml</strong>（定义服务、网络、卷）</li>
<li><strong>Dockerfile</strong>（基于官方 Hyperf 镜像定制）</li>
<li><strong>.env</strong>（可选，用于覆盖环境变量）</li>
<li><strong>config/</strong>、<strong>runtime/</strong>、<strong>public/</strong> 等标准 Hyperf 目录结构</li>
</ul>
<H3>Dockerfile（精简可靠版）</H3>
<p>放在项目根目录，内容如下（适配 Hyperf v3.x，支持多进程 & Redis 扩展）：</p>
<pre><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></pre>
<H3>docker-compose.yml（开箱即用）</H3>
<p>同级目录下创建该文件，集成 Nginx 反向代理 + Redis 缓存 + 日志卷：</p>
<pre><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></pre>
<p>⚠️ 注意：<font color="red">需自行准备 ./nginx.conf</font>（反代到 <code>http://app:9501</code>），示例可提供。</p>
<H3>一键部署脚本（deploy.sh）</H3>
<p>保存为 <font color="blue">deploy.sh</font>，赋予执行权限（<code>chmod +x deploy.sh</code>），运行即完成全流程：</p>
<pre><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></pre>
<H3>后续维护建议</H3>
<ul>
<li>更新代码后，只需重新运行 <code>./deploy.sh</code>（自动 rebuild & restart）</li>
<li>修改配置（如数据库）：编辑 <code>config/autoload/database.php</code> 或通过 <code>.env</code> 覆盖</li>
<li>查看实时日志：<code>docker-compose logs -f app</code></li>
<li>进入容器调试：<code>docker exec -it hyperf-app sh</code></li>
<li>备份 runtime 数据：<code>tar -czf runtime-backup.tar.gz runtime/</code></li>
</ul>
<p>不复杂但容易忽略：每次更新前确认 <code>.dockerignore</code> 已排除 <code>vendor</code>、<code>node_modules</code>、<code>.git</code>，避免镜像臃肿。</p>
