摘要：前言是一個在之上構(gòu)建的一個高性能協(xié)程全棧框架，而在里面是一個高級技能，所以在相關(guān)的環(huán)境安裝上也給許多人造成了很大的困擾，更是如此，本文將通過以一種極其簡單的方式解決運行環(huán)境和開發(fā)環(huán)境的部署。

本系列文章將從使用層面介紹 Swoft 框架的使用及業(yè)務(wù)開發(fā)，面向初中級的 PHPer

Swoft
首個基于 Swoole 原生協(xié)程的新時代 PHP 高性能協(xié)程全棧組件化框架，內(nèi)置協(xié)程網(wǎng)絡(luò)服務(wù)器及常用的協(xié)程客戶端，常駐內(nèi)存，不依賴傳統(tǒng)的 PHP-FPM，全異步非阻塞 IO 實現(xiàn)，以類似于同步客戶端的寫法實現(xiàn)異步客戶端的使用，沒有復(fù)雜的異步回調(diào)，沒有繁瑣的 yield，有類似 Go 語言的協(xié)程、靈活的注解、強大的全局依賴注入容器、完善的服務(wù)治理、靈活強大的 AOP、標(biāo)準(zhǔn)的 PSR 規(guī)范實現(xiàn)等等，可以用于構(gòu)建高性能的Web系統(tǒng)、API、中間件、基礎(chǔ)服務(wù)等等。

Swoft 是一個在 Swoole 之上構(gòu)建的一個高性能協(xié)程 PHP 全棧框架，而 Swoole 在 PHPer 里面是一個高級技能，所以在相關(guān)的環(huán)境安裝上也給許多人造成了很大的困擾，Swoft 更是如此，本文將通過 Docker 以一種極其簡單的方式解決運行環(huán)境和開發(fā)環(huán)境的部署。

從百科上可以看到，Docker 是一個開源的的應(yīng)用容器引擎，讓開發(fā)者可以打包他們的應(yīng)用以及依賴包到一個可移植的容器中，然后發(fā)布到任何流行的Linux機器上，也可以實現(xiàn)虛擬化，容器是完全使用沙箱機制，相互之間不會有任何接口，也可以理解為我們可以將我們的代碼和運行環(huán)境打包到一個容器中，打包好的容器可以發(fā)布到任何流行的Linux機器上，這里指的Linux機器其實并不準(zhǔn)確，得益于Docker for Windows項目和Hyper-V的發(fā)展，Docker也可以以不錯的狀態(tài)運行在Windows 10系統(tǒng)上，但筆者不建議將 Docker for Windows 用于生產(chǎn)環(huán)境上。

這里對 Docker 常用的的一些名詞進行簡單的闡述和解釋，以便新手對于下文的理解

Dockerfile，Dockerfile 是 Docker鏡像 的描述文件，通過 docker build 命令來構(gòu)建成為 鏡像

鏡像(Image)，通過 Dockerfile 構(gòu)建得到，包含操作系統(tǒng)及運行環(huán)境

容器(Container)，容器是運行起來的鏡像，可理解為鏡像是Docker生命周期中的構(gòu)建和打包階段，而容器則是啟動和執(zhí)行階段

鏡像倉庫(Repository)，用于儲存構(gòu)建好的 Docker鏡像 的倉庫，可理解為類似于 Git 的倉庫

Docker 的安裝流程并不復(fù)雜，本節(jié)將介紹 Linux 及 Windows 10 系統(tǒng)下的安裝流程，而 Mac 系統(tǒng)上并不建議采用 Docker 環(huán)境來運行或開發(fā) Swoft 項目，因為在 Mac for Docker 上共享磁盤的性能極其的差，會導(dǎo)致 Swoft 在啟動階段耗時極長。

在 Linux 上通過 yum 和 apt-get 來 安裝 Docker 的流程可謂是相當(dāng)簡單
CentOS：yum install docker -y
Ubuntu：apt-get install docker-engine -y
只需要根據(jù)系統(tǒng)的區(qū)別，在終端執(zhí)行上面的一行命令即可完成 Docker 的安裝，在安裝完成之后我們需要執(zhí)行一下 service docker start 命令來啟動一下 Docker 服務(wù)。

在安裝完 Docker 之后，我們還需要安裝一下 docker-compose 以便于后續(xù)對 Docker 的使用
CentOS：yum install python-pip -y && pip install --upgrade pip && pip install -U docker-compose
Ubuntu：apt-get install python-pip -y && pip install --upgrade pip && pip install -U docker-compose
只需要根據(jù)系統(tǒng)的區(qū)別，在終端執(zhí)行上面的一行命令即可完成 docker-compose 的安裝。

我們直接到 Docker 官網(wǎng)下載對應(yīng)的安裝包 https://store.docker.com/edit...，非登錄用戶我們會看到 Please Login to Download ，意思是要我們先登錄 Docker 賬號好再下載，我們直接點擊按鈕到登錄頁面完成賬號注冊或登錄即可在上面的鏈接頁面通過點擊 Get Docker 下載，注意這個賬號后面我們在使用時也會用到。
下載完安裝包后可直接運行安裝包進行安裝，整個過程可以說是傻瓜式的，持續(xù)的下一步即可，注意安裝前需先開啟系統(tǒng)的 Hyper-V，開啟流程相對簡單可參考其它文章 https://segmentfault.com/a/11... ，注意 Hyper-V 是與 VMware 是沖突的，兩者不能并存，只能擇其一，如果你必須要使用虛擬機的話，比如 Vagrant 之類的工具，亦可在虛擬機內(nèi)運行一個 Linux 系統(tǒng)，然后根據(jù)本文關(guān)于 Linux 系統(tǒng) 的安裝流程處理，在虛擬機內(nèi)運行 Docker 作為開發(fā)環(huán)境。
最新版的 Docker 安裝包已經(jīng)包含了 docker-compose 了，也就無需再做多余的操作。
安裝完成后，重啟電腦，當(dāng)你看到任務(wù)欄的 小鯨魚(Docker Icon) 顯示著 Docker is running 即表示 Docker 啟動成功了。

我們需要右鍵 Docker，點擊 Sign in / Create Docker ID 登錄我們剛才注冊的 Docker ID，以便獲得我們可以從 DockerHub 中獲取公共鏡像的權(quán)限。

由于我們是用于開發(fā)使用，所以我們還需要授權(quán)一下共享目錄的權(quán)限，右鍵 Docker 并點擊 Settings，設(shè)置界面切換到 Shared Drives，勾選你項目代碼所在的 磁盤盤符，并點擊右下角的 Apply 即可完成授權(quán)。

我們通過命令 git clone https://github.com/swoft-cloud/swoft 從 Github 上 克隆(clone) Swoft 項目，并使用項目自帶的 docker-compose.yml 文件來實現(xiàn)一個用于開發(fā)的環(huán)境，docker-compose.yml 是 docker-compose 的編排配置文件， 我們看一下官方默認(rèn)文件的內(nèi)容：

version: "3"
services:
    swoft:
        container_name: swoft
        image: swoft/swoft
        ports:
            - "80:80"
        volumes:
            - ./:/var/www/swoft
        stdin_open: true
        tty: true
        entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"]

這是一個相對簡單的編排文件，僅僅只有 swoft 一個服務(wù)，也沒有關(guān)聯(lián)過多的內(nèi)容，關(guān)于 docker-compose.yml 的文件格式我們這里不做過多的解釋，可自行查找相關(guān)的內(nèi)容進行閱讀理解。
簡單的解讀此文件的內(nèi)容可以理解為，使用了swoft/swoft官方鏡像并設(shè)置了容器名稱為swoft，綁定容器內(nèi)的80端口與宿主機的80端口，設(shè)置./當(dāng)前目錄與容器內(nèi)的/var/www/swoft目錄為共享目錄，開啟與容器的交互式終端并于啟動編排文件時啟動Swoft服務(wù)。
我們可以注意到默認(rèn)編排文件上的 entrypoint 配置了 php /var/www/swoft/bin/swoft start，也就是啟動 Swoft 服務(wù)的命令，但如果僅 克隆(clone) 項目并執(zhí)行 docker-compose up 來嘗試啟動 容器 的話，我們會得到一個失敗的結(jié)果，因為尚未執(zhí)行 composer install 來加載 Composer 的依賴而缺少 vendor 文件夾和 autoload 等相關(guān)文件，導(dǎo)致無法正確運行 Swoft 實例，我們再看默認(rèn)的編排文件設(shè)置了 stdin_open: true 和 tty: true 兩個參數(shù)，分別對應(yīng) docker 命令上的 -i 和 -t 兩個參數(shù)，簡單的理解就是 -i 開啟了 輸入(input)功能，-t 開啟了一個連接容器里面的 交互式終端(terminal) ，我們可以利用這兩個參數(shù)，并將編排文件的 entrypoint 行改為 entrypoint: ["sh"] ，使容器啟動后不是直接啟動 Swoft 服務(wù)，而是由我們手動通過 交互式終端(terminal) 進入容器內(nèi)去啟動。（注意Swoft官方已將入口從 command 改為了 entrypoint，本文已做對應(yīng)的更新）
下面是一個更改后的 docker-compose.yml 文件實例:

version: "3"
services:
    swoft:
        container_name: swoft
        image: swoft/swoft
        ports:
            - "80:80"
        volumes:
            - ./:/var/www/swoft
        stdin_open: true
        tty: true
        entrypoint: ["sh"]

此時我們在編排文件的所在目錄啟動一個 終端(Shell), 然后執(zhí)行 docker-compose up -d，-d 的意思是以守護模式(Daemon Mode) 運行，便于我們在同一個 終端(Shell) 進入到容器內(nèi)，命令執(zhí)行后我們可以看到 Starting swoft ... done 即表示啟動容器成功。
如果在執(zhí)行啟動命令時得到一下錯誤，則說明宿主機的80端口已經(jīng)被占用了，更改 docker-compose.yml 文件內(nèi)的 80:80 為其它未被占用的端口即可，注意第一個80指的是宿主機的端口，第二個80指的是容器內(nèi)的端口，也就是說我們只需要更改第一個即可

ERROR: for swoft Cannot start service swoft: b"driver failed programming external connectivity on endpoint swoft(dab0f4d00620e2f5c07e33084ca5cac6f08cb48018d6b737eadc035e5aa0b597): Bind for 0.0.0.0:80 failed: port is already allocated"

通過執(zhí)行 docker ps 命令可以查看啟動的容器信息，下面為示例信息：

CONTAINER ID  IMAGE               COMMAND                 CREATED             STATUS             PORTS               NAMES
f22173763374  swoft/swoft:latest  "docker-php-entrypoin"  About a minute ago  Up About a minute  0.0.0.0:80->80/tcp  swoft

得知 容器ID(Container ID) 為 f22173763374，容器名稱(Container Name)為 swoft，我們可以執(zhí)行 docker exec -it f22173763374 bash 或 docker exec -it swoft bash 通過 交互式終端(terminal) 進入到容器內(nèi)。

如執(zhí)行時報錯 the input device is not a TTY. If you are using mintty, try prefixing the command with "winpty"，可在 docker exec 命令前面增加 winpty 命令解決，即 winpty docker exec -it swoft bash

通過 docker exec 命令進入容器后，我們留意到光標(biāo)左側(cè)的內(nèi)容變?yōu)?root@f22173763374: 即為已進入容器內(nèi)，其中 f22173763374 為對應(yīng)的 容器ID(Container ID)。
由于 Swoft 官方鏡像 swoft/swoft 配置的工作目錄為 /var/www/swoft，而 docker-compose.yml 又將項目當(dāng)前目錄關(guān)聯(lián)了容器 /var/www/swoft 目錄，即通過 docker exec 進入的目錄已經(jīng)為 /var/www/swoft 目錄，即項目目錄，所以我們可以直接執(zhí)行 composer install 命令來加載 Composer 的依賴并生成 自動加載(Autoload) 文件。
考慮到國內(nèi)的網(wǎng)絡(luò)環(huán)境，我們在執(zhí)行 composer install 命令前可以先執(zhí)行 composer config -g repo.packagist composer https://packagist.phpcomposer.com 命令配置 Composer 中國鏡像源 加速安裝速度（由于近期Packagist中國鏡像源一直處于不可用狀態(tài)，建議轉(zhuǎn)至Laravel-China中國源，即 config -g repo.packagist composer https://packagist.laravel-china.org）。

安裝完 Composer 依賴后，便可以執(zhí)行 php bin/swoft start 啟動服務(wù)了，當(dāng)你看到

root@f22173763374:/var/www/swoft# php bin/swoft start
                         Server Information
********************************************************************
* HTTP | host: 0.0.0.0, port: 80, type: 1, worker: 1, mode: 3
* TCP  | host: 0.0.0.0, port: 8099, type: 1, worker: 1 (Enabled)
********************************************************************
Server has been started. (master PID: 15, manager PID: 16)
You can use CTRL + C to stop run.

即意味著你的 Swoft 以及啟動成功了，我們可以打開瀏覽器訪問一下 http://127.0.0.1:80，當(dāng)你看到下圖即大功告成了！

如果你綁定宿主機的端口不是80，則改成對應(yīng)的即可；
如果訪問看到的是 Redis connection failure host=127.0.0.1 port=6379 則說明缺少 Redis 服務(wù)，最簡單直接的就是直接在當(dāng)前容器內(nèi)安裝 Redis Server，直接執(zhí)行 apt install -y redis-server && service redis-server start 即可完成安裝以及啟動操作了；

Swoft 跟 PHP-FPM 模式下的開發(fā)會有一點差異，在PHP-FPM模式下直接改變代碼內(nèi)容，再訪問對應(yīng)的代碼便能得到變更后的內(nèi)容，是因為PHP-FPM模式下每一次請求都會重新加載PHP代碼，而 Swoft 是持久化運行的，也就意味著代碼在服務(wù)啟動之后，接受的請求都無需重新加載，這個模式的變化可以使得 Swoft 的大量代碼可被重復(fù)使用，而無需重新加載和重新實例化，大大提升性能的其中一點原因之一。
這樣的變更對開發(fā)會造成一定程度的影響，也就是說在 Swoft 下，你需要 重啟 Worker 或 重啟服務(wù) 才能使變更的代碼生效，但是得益于 Swoft 的 熱重載 功能，可以自動檢查代碼變更并自動 重啟 Worker，我們只需通過項目根目錄下的 .env 文件更改 AUTO_RELOAD 項為 true 即可，如項目根目錄下沒有 .env 文件，可直接復(fù)制 .env.example 文件為 .env 并作出對應(yīng)的更改即可，有一點需要注意的是僅在改變 app 目錄下的代碼才會被 熱重載 功能重載，改變其它代碼不會被重載，這是由于不同代碼是處于不同的生命周期導(dǎo)致的，僅 WorkerStart 之后加載的代碼才能被重載，關(guān)于這部分的內(nèi)容我們將在后續(xù)涉及到 Swoft 的生命周期 時再做進一步的講解。