使用 docker-compose 快速搭建 Hyperf + Redis 开发环境

0x00: 为什么要使用docker-compose搭建开发环境

使用线上环境镜像, 开发环境与线上环境保持一致, 包括PHP版本, Swoole版本以及各种扩展版本
无需手动安装PHP和Swoole等运行环境
跨Windows / Linux / macOS部署
无需手动安装Redis

0x01: 准备工作

安装
确认本机9501端口没有占用(lsof -i :9501)
确认本机6379端口没有占用(lsof -i :6379)

0x02: docker-compose.yaml

version: "3.7"
services:
  redis:
    image: redis
    container_name: redis
    ports:
      - 6379:6379
    volumes:
      - type: volume
        target: /data
        source: redis
  hyperf:
    image: bcycr-registry.cn-hangzhou.cr.aliyuncs.com/base/hyperf:7.4-v1
    stdin_open: true
    tty: true
    container_name: hyperf
    environment:
      REDIS_HOST: redis
      SCAN_CACHEABLE: (false)
    volumes:
      - $APP_ROOT:/opt/www
    ports:
      - 9501:9501
    links:
      - redis
    depends_on:
      - redis
volumes:
  redis: { }

0x03: 使用步骤

将上面的docker-compose.yaml内容保存到本地的docker-compose.yaml中, 下例保存到/root/docker-compose.yaml
将docker-compose.yaml:18行的$APP_ROOT替换为Hyperf项目的绝对路径
运行docker-compose -f /root/docker-compose.yaml up -d, 注意将/root/docker-compose.yaml替换为实际的docker-compose.yaml路径
```
2m@2ms-MacBook-Pro bcy-next % docker-compose -f docker-compose.yaml up -d
Starting redis ... done
Starting hyperf ... done
```

运行docker ps查看正在运行的容器, 正常情况下应该看到

2m@2ms-MacBook-Pro bcy-next % docker ps
CONTAINER ID        IMAGE                                                           COMMAND                  CREATED             STATUS              PORTS                    NAMES
30a8b491cad5        bcycr-registry.cn-hangzhou.cr.aliyuncs.com/base/hyperf:7.4-v1   "/bin/sh"                38 minutes ago      Up 15 minutes       0.0.0.0:9501->9501/tcp   hyperf
7c4c6b05a251        redis                                                           "docker-entrypoint.s…"   46 minutes ago      Up 15 minutes       0.0.0.0:6379->6379/tcp   redis

此时redis和hyperf容器都已经运行并且监听了6379和9501端口, 但hyperf应用并没有启动, 需要进入容器启动hyperf

运行docker exec -it hyperf bash打开hyperf容器的终端, 此时可以使用php bin/hyperf.php start运行hyperf应用或者运行其它的命令
```
2m@2ms-MacBook-Pro bcy-next % docker exec -it hyperf bash
bash-5.0# php bin/hyperf.php -V
Console Tool
```

0x04: 连接Redis

由于docker-compose.yaml中声明了links, 所以hyperf容器可以直接使用redis作为host连接redis, environment字段已经自动设置了REDIS_HOST环境变量, 如果.env中有REDIS_HOST需要注释掉

0x05: 宿主机访问

Redis和Hyperf容器均可以通过宿主机回环地址直接访问

2m@2ms-MacBook-Pro bcy-next % curl http://127.0.0.1:9501/healthz
ok%

2m@2ms-MacBook-Pro bcy-next % redis-cli             
127.0.0.1:6379> ping
PONG

0x06: 停止

docker-compose -f /root/docker-compose.yaml down -d

上一页搭建 k8s 集群下一页Kubernetes Autoscaler

最后更新于2年前

这有帮助吗？

version: "3.7" services: redis: image: redis container_name: redis ports: - 6379:6379 volumes: - type: volume target: /data source: redis hyperf: image: bcycr-registry.cn-hangzhou.cr.aliyuncs.com/base/hyperf:7.4-v1 stdin_open: true tty: true container_name: hyperf environment: REDIS_HOST: redis SCAN_CACHEABLE: (false) volumes: - $APP_ROOT:/opt/www ports: - 9501:9501 links: - redis depends_on: - redis volumes: redis: { }

2m@2ms-MacBook-Pro bcy-next % docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 30a8b491cad5 bcycr-registry.cn-hangzhou.cr.aliyuncs.com/base/hyperf:7.4-v1 "/bin/sh" 38 minutes ago Up 15 minutes 0.0.0.0:9501->9501/tcp hyperf 7c4c6b05a251 redis "docker-entrypoint.s…" 46 minutes ago Up 15 minutes 0.0.0.0:6379->6379/tcp redis