共计 4366 个字符,预计需要花费 11 分钟才能阅读完成。
Swoft
首个基于 Swoole 原生协程的新时代 PHP 高性能协程全栈框架,内置协程网络服务器及常用的协程客户端,常驻内存,不依赖传统的 PHP-FPM,全异步非阻塞 IO 实现,以类似于同步客户端的写法实现异步客户端的使用,没有复杂的异步回调,没有繁琐的 yield, 有类似 Go 语言的协程、灵活的注解、强大的全局依赖注入容器、完善的服务治理、灵活强大的 AOP、标准的 PSR 规范实现等等,可以用于构建高性能的 Web 系统、API、中间件、基础服务等等。
Swoft 的 Docker 镜像
突然白话文 使用 docker 安装 swoft 其实听起来比较怪怪的,swoft 是一套 php 框架,依赖 swoole 扩展,说 docker 安装 swoft,其实是 docker 安装 swoft 运行所需的组件依赖和环境。
swoft 框架运行环境所需的依赖和环境挨个安装搭建还是需要一些时间的,比如 php 版本 >= 7.1, swoole 版本 >= 2.1, 而且还要安装 hiredis 来协助开启 swoole 的异步 redis 客户端,同时要求 swoole 开启协程模式等。
所以呢,为了节省我们的时间,官方提供了一个 docker 镜像包,里面包含了 swoft 运行环境所需要的各项组件:
php 7.1+swoole 2.1+ –enable-async-redis-client –enable-coroutinecomposerpecl
我们只需要下载镜像并新建一个容器,这个容器就提供了 swoft 框架所需的所有依赖和环境,我们只需要将本地的 sowft 项目挂载到镜像的 swoft 工作目录 /var/www/swoft 下,就可以继续我们的开发或生产工作了。让你从 swoft 略繁琐的依赖和环境搭建中解放出来,直接进入业务开发工作中去。
一开始我没理解好这个 swoft 镜像,镜像里自带的框架其实是单纯的用来体验的,我一直误以为要编辑镜像的 swoft 框架源码做开发 ….
需要特别注意的是,sowft 镜像的 entrypoint 命令(运行初始化命令)是
ENTRYPOINT [“php”, “/var/www/swoft/bin/swoft”, “start”]
即容器启动时会同时启动 swoft 框架,这就需要如果我们挂载本地 swoft 项目到镜像工作目录时,本地的 swoft 项目需已安装好框架的各依赖组件。我们从 git 上直接拉取的 swoft 项目是没有安装这些组件的,需使用 composer install [–no-dev] 安装,框架才能正常启动,这就要求宿主机上至少要有基础的 php + composer 的环境。当然,镜像内是工作目录下是有一套完全安装的 swoft 框架的,如果你只是为了体验,直接启动容器就好,但没什么直接的意义。在后面我们将给出一个只需要在宿主机上安装运维所需的 docker docker-compose git 即可完全借助 swoft 镜像去部署开发或生产环境的方法(修改镜像 entrypoint 到 bash 模式,然后进入镜像后使用 composer 安装依赖,启动 swoft)
Docker 部署 swoft
宿主机仍需安装基本的 php / composer(或者你把自己本地开发的项目 cp 过来,但这样可能会导致部分组件版本不一致,还是提交业务代码 + composer.json + composer.lock 文件,排除 vendor 目录,在线上服务器再 composer install 一遍最为规范)
1、在宿主机创建 swoft 项目(宿主机需实安装基础的 php 环境来使用 composer)
composer create-project –prefer-dist swoft/swoft swoft [–dev] && cd swoft
或者
git clone git@github.com:swoft-cloud/swoft.git && cd swoft && composer install && cd swoft
2、拉取 swoft 镜像 创建 swoft 容器 并将宿主机上安装好的 swoft 项目挂载到 swoft 容器的工作目录
// 拉取 swoft 镜像
// 关联本地 swoft 项目目录到镜像的项目目录 (/var/www/swoft)
// 映射主机 8081 端口 到 容器 80 端口
// 容器命名为 mySwoft
// 守护模式启动
docker run -v $(pwd):/var/www/swoft -p 8081:80 –name mySwoft -d swoft/swoft
// 查看容器是否运行
docker ps
// 查看容器日志
docker logs mySwoft
3、进入 swoft 容器 shell
// 交互模式执行 mySwoft 容器的 bash
docker exec -it mySwoft bash
// stop 会停止容器所以会退出 shell 后用 docker start mySwoft 启动就好
root@cce12db9add3:/var/www/swoft# php bin/swoft start|stop|reload
// 因我们将宿主机上的 swoft 项目挂载到了 swoft 容器的项目目录 /var/www/swoft 所以后期开发修改宿主机上的项目即可
// 可以使用 PS 的 FTP 同步工具
可以在 swoft 的容器 shell 里通过命令查看相应的组件版本
root@cce12db9add3:/var/www/swoft# php -v
root@cce12db9add3:/var/www/swoft# php –ri swoole
root@cce12db9add3:/var/www/swoft# composer -V
root@cce12db9add3:/var/www/swoft# pecl -V
Docker Composer 部署 Swoft
宿主机仍需安装基本的 php / composer(或者你把自己本地开发的项目 cp 过来,但这样可能会导致部分组件版本不一致,还是提交业务代码 + composer.json + composer.lock 文件,排除 vendor 目录,在线上服务器再 composer install 一遍最为规范)swoft 项目中是有 docker-compose.yml 文件的
version: ‘3’
services:
swoft:
image: swoft/swoft:latest
# build: ./
ports:
– “80:80” #端口映射
volumes:
– ./:/var/www/swoft # 挂载当前路径下的本地 swoft 项目到镜像项目路径
stdin_open: true #打开标准输出
tty: true # 打开 tty 会话
privileged: true # 给与权限 比如创建文件夹之类的
entrypoint: [“php”, “/var/www/swoft/bin/swoft”, “start”] # 入口启动命令 即启动 swoft 服务
使用方法自然比直接用 docker 方便些,不过依旧是要在宿主机上先创建一个 swoft 项目
1、在宿主机创建 swoft 项目(宿主机需实安装基础的 php 环境来使用 composer)
composer create-project –prefer-dist swoft/swoft swoft [–dev] && cd swoft
或者
git clone git@github.com:swoft-cloud/swoft.git && cd swoft && composer install && cd swoft
2、使用 docker-compose 来编排启动容器
编辑 docker-compose.yaml 文件 给容器自定义个名字
version: ‘3’
services:
swoft:
image: swoft/swoft:latest
container_name: mySwoft # 给容器自定义个名称便于管理
# build: ./
ports:
– “80:80” #端口映射
volumes:
– ./:/var/www/swoft # 挂载当前路径下的本地 swoft 项目到镜像项目路径
stdin_open: true #打开标准输出
tty: true # 打开 tty 会话
privileged: true # 给与权限 比如创建文件夹之类的
entrypoint: [“php”, “/var/www/swoft/bin/swoft”, “start”] # 入口启动命令 即启动 swoft 服务
# 启动容器
docker-compose up -d swoft
# 查看容器是否成功运行
docker ps
# 进入容器 shell
docker exec -it mySwoft bash
如何在未安装 PHP 环境的宿主机上部署 swoft
前面两种部署 swoft 的方法都需要在宿主机上安装 php 基础环境来使用 composer 安装好本地 swoft 项目的依赖组件,才能与 swoft 镜像的工作目录挂载,启动容器(因为容器的入口命令就是直接启动 swoft,如果我们挂载本地未安装好依赖的 swoft 项目到镜像工作目录,那容器就会启动失败退出了),下面我们介绍一种不需要在宿主机上安装 php / composer 的方法。
git+ docker + docker-composer
1、拉取 swoft(拉取就好,不需要安装)
git clone git@github.com:swoft-cloud/swoft.git && cd swoft && cd swoft
2、编辑 docker-composer.yaml 文件
修改容器启动的 entrypoint 命令,让容器启动,但不启动 swoft,等我们进入容器,使用容器中自带的 composer 安装好框架组件依赖后再启动 swoft
version: ‘3’
services:
swoft:
container_name: mySwoft
image: swoft/swoft:latest
# build: ./
ports:
– “8082:80” # 映射宿主机 8082 端口到 容器 80
volumes:
– ./:/var/www/swoft
stdin_open: true # 一定要开启此项 否则容器会因 bash 执行完退出
tty: true
privileged: true
# entrypoint: [“php”, “/var/www/swoft/bin/swoft”, “start”]
entrypoint: [“bash”] # 改为此命令后 启动容器时默认不会启动 swoft 所以即使框架依赖未安装 也不会影响容器启动
3、保存 docker-composer.yaml 后启动容器
docker-composer up -d swoft
4、进入容器 shell 使用容器种的 composer 安装框架依赖
docker exec -it mySwoft bash
composer install [–no-dev]
5、启动 swoft
php bin/swoft start|stop|restart
这种方法使得宿主机完全省去了还要事先简单安装下 php / composer 的工作,完全发挥镜像的功能~