摘要：所以呢，為了節省我們的時間，官方提供了一個鏡像包，里面包含了運行環境所需要的各項組件我們只需要下載鏡像并新建一個容器，這個容器就提供了框架所需的所有依賴和環境，將宿主機上的項目掛載到鏡像的工作目錄下，就可以繼續我們的開發或生產工作了。

首個基于 Swoole 原生協程的新時代 PHP 高性能協程全?？蚣?，內置協程網絡服務器及常用的協程客戶端，常駐內存，不依賴傳統的 PHP-FPM，全異步非阻塞 IO 實現，以類似于同步客戶端的寫法實現異步客戶端的使用，沒有復雜的異步回調，沒有繁瑣的 yield, 有類似 Go 語言的協程、靈活的注解、強大的全局依賴注入容器、完善的服務治理、靈活強大的 AOP、標準的 PSR 規范實現等等，可以用于構建高性能的Web系統、API、中間件、基礎服務等等。

突然白話文

使用 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-coroutine
composer
pecl

我們只需要下載鏡像并新建一個容器，這個容器就提供了 swoft 框架所需的所有依賴和環境，將宿主機上的 sowft 項目掛載到 swoft 鏡像的工作目錄 /var/www/swoft 下，就可以繼續我們的開發或生產工作了。讓你從 swoft 略繁瑣的依賴和環境搭建中解放出來，直接進入業務開發工作中去。

一開始我沒理解好這個 swoft 鏡像，鏡像里自帶的框架其實是單純的用來體驗的，我一直誤以為要編輯鏡像的 swoft 框架源碼做開發....

需要特別注意的是，sowft 鏡像的 entrypoint 命令（運行初始化命令）是
ENTRYPOINT ["php", "/var/www/swoft/bin/swoft", "start"]

即 swoft 服務會隨著容器而啟動，這就要求我們如果選擇將宿主機上開發用的 swoft 項目掛載到容器工作目錄時，需已完全安裝才可以（使用 composer 安裝好各依賴）。同時容器使用 swoft服務 作為前置進程，若我們想停止/啟動來重新載入 swoft服務 時，容器也會跟隨退出，這樣就略有不便了。所以，為了后續開發方便，我們應分離 swoft 服務作為容器的前臺進程，使得在容器內 重啟/停止 swoft 服務不影響容器自身運行。當然，如果只是單純的體驗 swoft，直接創建并啟動容器即可，鏡像中已有一套完全安裝的 swoft框架。

在后面我們將給出一個只需要在宿主機上安裝運維所需的 docker/docker-compose/git 即可完全借助 swoft鏡像 去部署開發或生產環境的方法（修改鏡像 entrypoint 到 bash 模式，然后進入鏡像后使用 composer 安裝依賴，啟動 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

宿主機仍需安裝基本的 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

前面兩種部署 swoft 的方法都需要在宿主機上安裝 php 基礎環境來使用 composer 安裝好本地 swoft 項目的依賴組件，才能與 swoft 鏡像的工作目錄掛載，啟動容器（因為容器的入口命令就是直接啟動 swoft，如果我們掛載本地未安裝好依賴的 swoft 項目到鏡像工作目錄，那容器就會啟動失敗退出了），下面我們介紹一種不需要在宿主機上安裝 php / composer 的方法。

1、拉取 swoft（拉取就好，不需要安裝依賴）

git clone git@github.com:swoft-cloud/swoft.git && cd swoft

# -it 開啟標準輸入及終端
# --entrypoint 覆蓋鏡像內默認啟動 swoft 服務的設定
# -d 守護模式
# 這樣便使得容器在啟動時會創建一個 bash 作為前置進程 而不啟動 swoft 服務
docker run -it -d -p 80:80 
-v $(pwd):/var/www/swoft 
--name mySwoft 
--entrypoint="" 
swoft/swoft bash

# 啟動后進入容器
docker exec -it mySwoft bash
# 使用容器內的 composer 安裝依賴 此時的工作目錄已于宿主機的swoft項目關聯
compose intall [--no-dev]
# 啟動 swoft
php bin/swoft start
# 此時停止 swoft 也不會導致容器退出
php bin/swoft stop

編輯 docker-compose.yml 文件，開啟 stdin_open（等同于docker的 -i）, tty（等同于docker的 -t）, entrypoint 改為 bash。

version: "3"

services:
    swoft:
       container_name: mySwoft
       image: swoft/swoft:latest
#      build: ./
       ports:
         - "8082:80" # 映射宿主機 8082 端口到 容器 80
       volumes:
         - ./:/var/www/swoft # 將宿主機的當前項目目錄掛載到容器的工作目錄 /var/www/swoft
       stdin_open: true # 一定要開啟此項 否則容器會因 bash 執行完退出
       tty: true # 開啟會話終端
       privileged: true
#      entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"]
       entrypoint: ["bash"] # 改為此命令后 啟動容器時默認不會啟動 swoft 所以即使框架依賴未安裝 也不會影響容器啟動

保存 docker-compose.yml 后啟動容器

docker-compose up -d swoft

進入容器 shell 使用容器種的 composer 安裝框架依賴

# 進入容器shell
docker exec -it mySwoft bash
# 會默認在 swoft 鏡像的工作目錄 /var/www/swoft 此目錄以和宿主機的swoft項目目錄映射在一起了
# 用容器內的 composer 安裝依賴
composer install [--no-dev]
#啟動 swoft
php bin/swoft start|stop|restart

這樣使得宿主機完全省去了還要事先簡單安裝下 php / composer 的工作，完全利用鏡像提供的現成的環境~