rshop/swoole Docker 镜像 - 轩辕镜像

RSHOP swoole Docker镜像文档

1. 镜像概述

RSHOP swoole Docker镜像是专为RSHOP应用设计的容器化解决方案，基于Swoole高性能网络通信框架构建，集成了RSHOP应用运行所需的基础依赖环境。该镜像旨在简化RSHOP应用的部署流程，提供一致、高效、稳定的运行环境，支持多场景下的快速搭建与扩展。

2. 核心功能与特性

• 基于Swoole框架：利用Swoole的异步IO、并发处理能力，提升RSHOP应用的性能与响应速度，支持高并发场景下的稳定运行。
• 预配置依赖环境：内置RSHOP应用所需的PHP扩展、系统库及配置文件，减少部署时的环境配置工作，降低环境差异导致的问题。
• 轻量级设计：基于精简的基础镜像构建，优化镜像体积，减少资源占用，提升部署与启动效率。
• 灵活配置支持：支持通过环境变量、配置文件挂载等方式自定义应用参数，适配开发、测试、生产等不同环境需求。
• 安全稳定：集成基础安全加固配置，保障应用运行过程中的稳定性与安全性。

3. 使用场景

• 开发环境搭建：为开发团队提供统一的本地运行环境，避免因开发环境差异导致的代码运行问题。
• 测试环境部署：快速在测试服务器上部署RSHOP应用，支持自动化测试、功能验证及性能测试。
• 生产环境运行：作为生产环境的容器化部署方案，提供稳定的服务运行载体，支持与容器编排工具（如Kubernetes、Docker Compose）集成实现规模化部署。

4. 使用方法与配置说明

4.1 快速启动（docker run）

通过以下命令可快速启动RSHOP swoole容器：

bash
docker run -d \
  --name rshop-swoole \
  -p 9501:9501 \  # Swoole服务端口映射（根据实际配置调整）
  -v /path/to/rshop/code:/app \  # 挂载本地RSHOP代码目录（可选，开发环境使用）
  -e RSHOP_ENV=prod \  # 环境变量：运行环境（dev/test/prod）
  -e DB_HOST=mysql-host \  # 环境变量：数据库主机地址
  -e DB_PORT=3306 \  # 环境变量：数据库端口
  -e DB_USER=root \  # 环境变量：数据库用户名
  -e DB_PASSWORD=password \  # 环境变量：数据库密码
  rshop/swoole:latest

4.2 环境变量配置

镜像支持通过-e参数传递环境变量自定义配置，常用环境变量说明如下：

4.3 Docker Compose配置示例

通过Docker Compose可更便捷地管理多容器应用（如关联数据库、Redis等），示例docker-compose.yml配置如下：

yaml
version: '3'
services:
  rshop-swoole:
    image: rshop/swoole:latest
    container_name: rshop-swoole
    ports:
      - "9501:9501"
    volumes:
      - ./rshop-code:/app  # 本地代码目录挂载（开发环境）
      - ./logs:/var/log/rshop  # 日志目录挂载
    environment:
      - RSHOP_ENV=dev
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=root
      - DB_PASSWORD=***
      - SWOOLE_WORKER_NUM=4
    depends_on:
      - mysql  # 依赖数据库服务（需在compose中定义mysql服务）

5. 注意事项

• 代码挂载：开发环境建议通过-v挂载本地代码目录，实现代码热更新；生产环境建议将代码内置到镜像中，避免外部依赖。
• 端口映射：根据Swoole服务配置的实际监听端口调整-p参数的端口映射关系。
• 环境变量安全：生产环境中敏感信息（如数据库密码）建议通过Docker Secrets、环境变量文件（--env-file）等方式传递，避免明文暴露。
• 资源限制：通过--memory、--cpus等参数限制容器资源使用，避免资源占用过高影响其他服务。