徒手用Docker構建自己的PHP開發環境

1. 前言

1.1 為什麼要用Docker ？

是否有這樣的場景，你搞了一個專案，在本地開發時需要搭建環境，放到線上時也需要搭建環境，到公司想暗戳戳玩一下要搭建環境，不搭還不行，因為你的環境依賴還挺多。這個時候如果有了Docker，只需要在機器上裝個Docker，放上寫好的Dockerfile，一行命令就自動完成這個事，方便又高效，豈不是很爽？

1.2 準備

接下來，本文介紹如何搭建一個PHP的開發環境，將用zPhal-dockerfiles[1]做為例子，這是我為我的部落格系統準備的一套Dockerfile。

現在不管是Windows、Mac還是Linux，Docker都可以很好支援，包括Windows系統，在Win 10系統下Docker for Windows 其實還是挺不錯的，就是比較吃記憶體。

透過Docker命令列，我們可以做很多事情，拉取映象，執行容器，容器內執行命令等，但是現在，我們要用更加簡單粗暴的方式，編寫好Dockerfiles檔案，然後透過docker-compose管理好這些檔案，簡化操作流程。

什麼是Dockerfile？

Dockerfile是由一系列命令和引數構成的指令碼，這些命令應用於拉取的基礎映象並最終建立一個新的映象，透過Dockerfile我們可以建立一個你需要的映象，裡面是包含了你要安裝的軟體，相當於是提前定製好要安裝的拓展，執行的命令等，然後一鍵執行，極大地簡化操作流程。

按照本文來搭建環境，你需要：

• 首先瞭解一下Docker以及Docker的一些基本操作，還有docker-compose是什麼。

• 然後需要安裝Docker和docker-compose，我將使用docker-compose來管理我的Dockerfiles。

註意，編寫Dockerfile是活的，不是死的，每個人寫出來的Dockerfile都會不一樣，取決於你的需求。

Docker的官方檔案非常清楚，雖然是英文，但是基本上什麼都有，有問題上檔案翻是非常明智的：Docker Documentation[2]。

2. 開始編寫

接下來都是以zPhal-dockerfiles[1]為例子，完整的可以點連結進去看，下麵的只是片段。

2.1 預覽

首先，我們來看一下，我建立的這個Dockerfile專案，我大概分成了下麵的目錄（當然這個是自己定的，並不是要求這麼去排版你的檔案）：

zPhal-dockerfiles
   app/
       index.php
       phpinfo.php
   data/
       .gitignore
   files/
       mysql/
           conf.d/
               mysql-file.cnf
           Dockerfile
       nginx/
           conf.d/
               default.conf
               zphal.conf
           Dockerfile
           nginx.conf
       php/
           pkg/
               .gitignore
           Dockerfile
           php.ini
           php-dev.ini
           php-fpm.conf
       redis/
           Dockerfile
       docker-compose.yml
   logs/
   .gitgnore
   README.md

在這個專案裡，我用到PHP、MySQL、Nginx、Redis以及Composer、Phalcon拓展等。

總的來說，我們做這件事有三個流程：編寫好各個軟體的Dockerfile；編寫好配置檔案；透過docker-compose處理所有的Dockerfile，包括將配置配置檔案扔進去Dockerfile檔案將構建的映象中。

2.2 編寫Dockerfile檔案

2.2.1 PHP

下麵是PHP的Dockerfile：

FROM php:7.2-fpm
MAINTAINER goozp "gzp@goozp.com"
# 設定時區
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
# 更新安裝依賴包和PHP核心拓展
RUN apt-get update && apt-get install -y \
        git \
        libfreetype6-dev \
        libjpeg62-turbo-dev \
        libpng-dev \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \
    && docker-php-ext-install -j$(nproc) gd \
        && docker-php-ext-install zip \
        && docker-php-ext-install pdo_mysql \
        && docker-php-ext-install opcache \
        && docker-php-ext-install mysqli \
        && rm -r /var/lib/apt/lists/*
# 將預先下載好的拓展包從宿主機複製進去
COPY ./pkg/redis.tgz /home/redis.tgz
COPY ./pkg/cphalcon.tar.gz /home/cphalcon.tar.gz
# 安裝 PECL 拓展，這裡我們安裝的是Redis
RUN pecl install /home/redis.tgz && echo "extension=redis.so" > /usr/local/etc/php/conf.d/redis.ini
# 安裝第三方拓展，這裡是 Phalcon 拓展
RUN cd /home \
    && tar -zxvf cphalcon.tar.gz \
    && mv cphalcon-* phalcon \
    && cd phalcon/build \
    && ./install \
    && echo "extension=phalcon.so" > /usr/local/etc/php/conf.d/phalcon.ini
# 安裝 Composer
ENV COMPOSER_HOME /root/composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
ENV PATH $COMPOSER_HOME/vendor/bin:$PATH
RUN rm -f /home/redis.tgz \
        rm -f /home/cphalcon.tar.gz 
WORKDIR /data
# Write Permission
RUN usermod -u 1000 www-data

第一行定義了基礎映象，這裡我們用了PHP 7.2的fpm版本，這裡第二行定義了一個維護者。

接下來定義了時區，在每一個Dockerfile都定義了這一句，主要是為了使所有的容器的時間都與宿主機同步，其實我們可以在docker-composer.yml檔案中這麼定義：

services:
  php-fpm:
    volumes:
      - /etc/localtime:/etc/localtime:ro

但是在非Linux系統，比如Windows中執行時，我們不能取到/etc/localtime，為了更大相容所有平臺，我把時間同步寫到Dockerfile中。

接下來安裝一些拓展，其實安裝拓展的過程類似於我們徒手在Linux中安裝PHP拓展，值得一提的是Composer。我將Composer直接安裝在了php-fpm的映象中，其實官方也提供了Composer的映象，拉取Composer映象執行也可以達到目的，因為我們使用Composer只是為了執行Composer命令來管理我們的包，如果Composer單獨是一個容器的話，我們在不用時，還可以將容器關掉；但是在這裡，我直接將Composer裝進php-fpm映象中，主要是我的專案安裝了一些PHP拓展，在編寫composer.json檔案時，我定義了extension的依賴，這樣Composer執行時會檢查環境是否安裝了這些依賴，所有如果我直接用Composer映象的話，還需要把我用的拓展安裝到映象裡，就麻煩多了，所以我直接在PHP映象中就把這個事做了，其實沒什麼區別，取決於你怎麼用。

2.2.2 Nginx

下麵是Nginx的Dockerfile：

FROM nginx:1.12
# set timezome
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

這個就簡單多了，我只設定了一個時間。因為我不需要安裝其它的東西，可以直接使用官方的映象。

當然，我們需要修改配置檔案，只要事先寫好配置檔案就行，最後在 docker-compose.yml 檔案中，將配置檔案扔進去，這個下麵會講，包括PHP的配置檔案，MySQL的配置檔案，都是一樣的。

2.2.3 MySQL

下麵是 MySQL 的 Dockerfile：

FROM mysql:5.7
# set timezome
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone


MySQL也沒有什麼特別之處，直接使用官方的映象。

2.2.4 Redis

下麵是Redis的，也直接使用官方映象：

FROM redis:3.2
# set timezome
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

2.3 編寫配置檔案

如何處理配置檔案呢，我將配置檔案進行歸類，PHP的配置檔案放在PHP目錄下，Nginx的配置放在Nginx目錄下，至於要不要再新建一個子檔案夾就看情況了，比如conf.d檔案夾。

下麵以Nginx配置檔案為例，首先Nginx目錄是這樣的：

nginx/
    conf.d/
        default.conf
        zphal.conf
    Dockerfile
    nginx.conf

除了nginx.conf外，還有一個子檔案夾conf.d用來存放所有的域名配置檔案，在Linux下搭建過PHP環境的應該都比較熟悉。這些配置檔案就是我們到時候要傳進去容器中的檔案，我們並不會在宿主機使用這些檔案。

所以需要註意的最重要一點就是，配置檔案中出現的路徑是容器內環境的路徑，而不是宿主機的路徑，每一個容器內都有一個執行環境，都是一臺微型小系統，這些路徑都是容器內的路徑。我們可以透過掛載與容器內通訊來同步檔案，在命令列啟動容器也需要掛載檔案路徑，而現在掛載這一步我們也用docker-compose來解決。

下麵是一個配置檔案示例：

server {
    listen   80 default;
    index index.html index.htm;
    server_name localhost docker;
    root /data/www;
    index index.php index.html index.htm;
    location / {
        try_files $uri $uri/ /index.html;
    }
    location ~ \.php {
        include fastcgi_params;
        fastcgi_pass   php-fpm:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  /data/www/$fastcgi_script_name;
    }
}

而root /data/www中，/data/www路徑，是到時候Nginx容器的路徑，而不是當前在操作的宿主機的路徑，所以到時候我們要掛載Web程式放的位置到這個路徑。

2.4 編寫 docker-compose.yml

在PHP、Nginx等目錄的同級，我們建立一個docker-compose.yml，我們在執行docker-compose相關命令時，會自動找到這個檔案，並根據裡面的內容來執行。

接上面Nginx的例子，我們先談掛載，因為這是最重要的一步。在docker-compose.yml中，Nginx的部分：

nginx:
    build: ./nginx
    depends_on:
      - php-fpm
    links:
      - php-fpm:php-fpm
    volumes:
      - ../app:/data/www:rw
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
      - ../logs/nginx:/var/log/nginx
    ports:
      - "80:80"
      - "8080:8080"
      - "443:443"
    restart: always
    command: nginx -g 'daemon off;'

有一個volumes引數，這裡就是我們要掛載的目錄的相關配置，第一條我們將../app掛載到/data/www之中，也是我們配置檔案中定義的預設監聽的root，而APP目錄是我們宿主機中的一個目錄，透過這樣掛載我們可以直接將我們的專案檔案放到APP中，Docker會幫你傳輸到容器內的/data/www目錄下。

其它的引數：

• build定義了你的Dockerfile在哪裡，如果沒有寫Dockerfile可以不用build，可以用images引數定義官方映象，比如image:mysql:5.7；

• depends_on表示將依賴其它映象，比如Nginx依賴php-fpm，沒有它我Nginx沒法玩；

• links定義連線，比如要連線到php-fpm容器，就是php-fpm:php-fpm，後面是別名；

• ports表示埠對映，80:80表示將80埠對映到宿主機的80埠；

• restart重啟，restart: always表示將自動重啟；

• command是自動執行的命令；

• ……

引數很多，更多的可以參考官方檔案。

下麵是一個完整的 docker-compose.yml 檔案：

version: '3.2'
services:
  php-fpm:
    build: ./php/
    ports:
      - "9000:9000"
    links:
      - mysql-db:mysql-db
      - redis-db:redis-db
    volumes:
      - ../app:/data/www:rw
      - ./php/php-dev.ini:/usr/local/etc/php/php.ini:ro
      - ./php/php-fpm.conf:/usr/local/etc/php-fpm.conf:ro
      - ../logs/php-fpm:/var/log/php-fpm:rw
    restart: always
    command: php-fpm
  nginx:
    build: ./nginx
    depends_on:
      - php-fpm
    links:
      - php-fpm:php-fpm
    volumes:
      - ../app:/data/www:rw
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
      - ../logs/nginx:/var/log/nginx
    ports:
      - "80:80"
      - "8080:8080"
      - "443:443"
    restart: always
    command: nginx -g 'daemon off;'
  mysql-db:
      build: ./mysql
      ports:
        - "3306:3306"
      volumes:
        - ../data/mysql:/var/lib/mysql:rw
        - ../logs/mysql:/var/lib/mysql-logs:rw
        - ./mysql/conf.d:/etc/mysql/conf.d:ro
      environment:
        MYSQL_ROOT_PASSWORD: 123456
        MYSQL_DATABASE: zphaldb
        MYSQL_USER: zphal
        MYSQL_PASSWORD: zphal123
      restart: always
      command: "--character-set-server=utf8"
  redis-db:
      build: ./redis
      ports:
        - "6379:6379"
      volumes:
        - ../data/redis:/data
      restart: always

3. 使用

這一套編寫下來，我們怎麼用呢？

3.1 使用搭建好的環境

首先，進入專案Dockerfiles的目錄下，這裡是files目錄：

cd zPhal-dockerfiles/files
 wget https://pecl.php.net/get/redis-3.1.6.tgz -O php/pkg/redis.tgz
 wget https://codeload.github.com/phalcon/cphalcon/tar.gz/v3.3.1 -O php/pkg/cphalcon.tar.gz

然後下載我們會用到的PHP拓展包。

執行命令：

docker-compose up

Docker會自動透過編寫好的docker-compose.yml內容構建映象，並且啟動容器。

如果沒問題，下次啟動時可以以守護樣式啟用，所有容器將後臺執行：

docker-compose up -d

關閉容器：

可以這樣關閉容器並刪除服務：

docker-compose down

使用 docker-compose 基本上就這麼簡單，用stop，start等這些命令來操縱容器服務。而更多的工作是在於編寫Dockerfile和docker-compose.yml檔案。

3.2 使用Composer

當我們要使用Composer時怎麼做呢？ 我們已經在php-fpm裡安裝了Composer。

用docker-compose進行操作：

docker-compose run --rm -w /data/www/zPhal php-fpm composer update

-w /data/www/zPhal為在php-fpm的工作區域，zPhal專案也是掛載在裡面，所有我們可以直接在容器裡執行Composer。

或者進入宿主機APP目錄下用Docker命令：

cd zPhal-dockerfiles/app
docker run -it --rm -v `pwd`:/data/www/ -w /data/www/zPhal files_php-fpm composer update

4. 註意事項

• 註意掛載路徑。

• 構建失敗時，註意容器內是否報錯。

• 加速映象。如果過程下載映象很慢，可以使用國內的加速映象服務。

相關連結：

1. https://github.com/ZpGuo/zPhal-dockerfiles

2. https://docs.docker.com/

原文連結：https://www.goozp.com/article/77.html

Kubernetes 實戰培訓

本次培訓內容包括：Docker容器的原理與基本操作；容器網路與儲存解析；Kubernetes的架構與設計理念詳解；Kubernetes的資源物件使用說明；Kubernetes 中的開放介面CRI、CNI、CSI解析；Kubernetes監控、網路、日誌管理；容器應用的開發流程詳解等，點選識別下方二維碼加微信好友瞭解具體培訓內容。

3月23日開始上課，點選閱讀原文連結即可報名。