twosee/swoole

Swoole-coroutine 镜像文档

https://hub.docker.com/r/twosee/swoole-coroutine/
https://github.com/twose/swoole-coroutine-docker

镜像概述

Swoole-coroutine镜像是基于PHP7.2-cli构建的高性能协程开发环境，集成Swoole最新稳定版本（1.X~4.X），并提供MySQL、Redis、Inotify等配套组件。镜像预装多种常用PHP扩展，开启全部Swoole功能，纯环境无冗余代码，默认配置中国上海时区，适合高级开发者快速构建高性能协程应用。

核心功能与特性

• 基础环境：基于PHP7.2-cli版本构建
• Swoole版本：集成Swoole 1.X~4.X最新稳定版本，所有功能默认开启
• 配套组件：提供MySQL、Redis、Inotify镜像，支持docker-compose一键部署
• 预装扩展：已安装GD、iconv、pdo_mysql、dom、xml、curl、swoole等PHP扩展
• 功能支持：开启协程（coroutine）、openssl、http2、async-redis、mysqlnd、swoole-serialize等全部功能
• 环境特性：纯环境无PHP代码或框架，绿色清洁；默认Asia/Shanghai时区；Inotify支持自动化热更新

版本标签说明

使用方法

拉取镜像

bash
# 拉取默认版本
docker pull twosee/swoole-coroutine

# 拉取MySQL配套版本
docker pull twosee/swoole-coroutine:mysql

# 拉取Redis配套版本
docker pull twosee/swoole-coroutine:redis

快速启动容器

bash
docker run -d --name=swoole \
  -v /本地工作目录:/workdir \
  -p 9501:9501 \
  twosee/swoole-coroutine \
  php /app/server.php start

Docker Compose部署（推荐）

以下配置实现Swoole+MySQL+Redis+Inotify完整环境：

yaml
version: '3.4'
services:
  swoole:
    image: "twosee/swoole-coroutine"
    ports:
      - "9501:9501"  # Swoole服务端口映射
    volumes:
      - ./src:/app/src:rw  # 挂载本地代码目录
    restart: always
    depends_on:
      - mysql  # 依赖MySQL服务
    command: php /app/src/server.php start  # 启动Swoole服务

  mysql:
    image: "twosee/swoole-coroutine:mysql"
    ports:
      - "9502:3306"  # MySQL端口映射
    volumes:
      - ./data/mysql/data:/var/lib/mysql:rw  # 数据持久化
      - ./data/mysql/sock:/var/run/mysqld:rw  # Windows环境可移除此行
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root_password_here  # root密码
      MYSQL_DATABASE: test  # 默认数据库
      MYSQL_USER: php  # PHP访问用户
      MYSQL_PASSWORD: php_user_password_here  # PHP用户密码
    
  redis:
    image: "twosee/swoole-coroutine:redis"
    ports:
      - "9503:6379"  # Redis端口映射
    volumes:
      - ./data/redis/data:/var/lib/redis:rw  # 数据持久化
    sysctls:
        net.core.somaxconn: 65535  # 优化TCP连接数
    restart: always

  inotify:
    image: "twosee/swoole-coroutine:inotify"
    volumes:
      - ./:/app:rw  # 挂载项目目录
    restart: always
    environment:
      APP_ENV: dev  # 环境标识（dev或product）
    working_dir: /app/util
    command: /bin/bash inotify.sh  # 启动热更新脚本

启动命令：

bash
docker-compose up

开发示例

MySQL连接示例

php
$options = [
  'host'     => 'mysql',  // 容器服务名（与docker-compose中一致）
  'port'     => 3306,
  'user'     => 'php',    // 对应docker-compose中MYSQL_USER
  'password' => 'php_user_password_here',  // 对应MYSQL_PASSWORD
  'database' => 'test'    // 对应MYSQL_DATABASE
];
$db = new \Swoole\Coroutine\Mysql();
$db->connect($options);

Redis连接示例

php
$redis = new \Swoole\Coroutine\Redis();
$redis->connect('redis', 6379);  // 'redis'为容器服务名
$val = $redis->get('foo');

配置说明

• MySQL配置详情：https://github.com/twose/swoole-coroutine-docker/tree/master/mysql
• Redis配置详情：https://github.com/twose/swoole-coroutine-docker/tree/master/redis