使用docker搭建PHP开发环境

为什么80%的码农都做不了架构师？>>>   

1.安装docker和docker-compose

1.1 docker的安装

本次安装使用的Linux发行版是Ubuntu 18.04,我们可以参照docker的官方文档进行安装，但是有些步骤需要做一些小修改。

首先，删除旧的docker版本:

$ sudo apt-get remove docker docker-engine docker.io containerd runc

接下来更新APT-GET的源头信息和安装相关的软件:

$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

接着添加docker的官方的GPG证书:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

接着可以使用下面的命令打印刚刚添加的证书:

$ sudo apt-key fingerprint 0EBFCD88

注意1：0EBFCD88是证书的后面8位字符。

注意2：上面的命令可以使用sudo apt-key finger 0EBFCD88或者apt-key list 0EBFCD88代替。

接下来，我们为APT-GET添加docker的软件源，但是我们这里没有安装官方文档进行,因为官方的软件源在国内的访问非常缓慢，我们这里使用了清华大学的docker软件源:

sudo add-apt-repository \
   "deb [arch=amd64] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu \
   $(lsb_release -cs) \
   stable"

接下来就是正式安装docker:

$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io

最后，我们可以通过运行hello-world容器来验证docker是否安装成功:

$ sudo docker run hello-world

输出如下:

1.2 安装docker-compose

因为我们搭建php的开发平台，我们需要最少PHP、MySQL、Nginx三个镜像，随着业务需求的增加，可能还需要Redis、Rabbitmq等等其他的镜像，管理这一系列的容器，如果每个容器单独管理的话，必然给工作带来不便，因此我们需要引入一个简单的容器编排工具docker-compose,下面是安装docker-compose的过程。

首先我们可以从github上面下载docker-compose运行文件，其实docker-compose是python开发的一个单文件的运行程序。

sudo curl -L "https://github.com/docker/compose/releases/download/1.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

我们用上述的命令将docker-compose文件下载到目录/usr/local/bin/,接下来我们要给予docker-compose可执行权限。

sudo chmod +x /usr/local/bin/docker-compose

然后我们可以验证一下docker-compose是否以及正确安装:

docker-compose -v

输出:

2.编写docker-compose.yml文件

我们对于docker容器的编排，我们都可以在docker-compose.yml文件中定义，首先看一下目录结构:

• docker-compose.yml是容器编排文件
• php/Dockerfile是php镜像的构建文件
• site.conf是NGINX中的网站配置文件
• code是php代码目录
• dbdata是mysql的数据存储目录

下面是我的docker-compose.yml配置文件:

version: '3'

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./code:/code
      - ./site.conf:/etc/nginx/conf.d/site.conf
    networks:
      - code-network
  
  php:
    #image: php:7.2-fpm
    build:
      context: ./php
      dockerfile: Dockerfile     
    image: my_php
    volumes:
      - ./code:/code
    networks:
      - code-network
  
  mysql:
    image: mysql:5.7
    ports:
      - 3307:3306
    volumes:
      - ./dbdata:/var/lib/mysql
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_ROOT_PASSWORD: 123456
      SERVICE_TAGS: dev
      SERVICE_NAME: mysql
    networks:
      - code-network


networks:
  code-network:
    driver: bridge

web和mysql服务都是直接使用了dockerHub中的官方镜像，但是php的官方镜像不能满足我们的需求，我们在官方php7.2的基础上做一些修改，下面是php镜像的Dockerfile:

FROM php:7.2-fpm

RUN docker-php-ext-install mysqli

RUN sed -i s/deb.debian.org/mirrors.163.com/g /etc/apt/sources.list /etc/apt/sources.list.d/buster.list
RUN sed -i s/security.debian.org/mirrors.163.com/g /etc/apt/sources.list /etc/apt/sources.list.d/buster.list

RUN apt-get update && apt-get install -y apt-utils
RUN apt-get install -y procps

RUN mkdir /code
RUN chown -R www-data:www-data /code

注意:上面配置文件中chown -R www-data:www-data /code改变了code文件夹的所属的用户，但是由于code文件夹是挂载进去的，所以后面运行镜像的时候，code里面的文件的用户组全部是www-data:www-data，这个和我们平常的情况不同，一般的情况是设置完code文件夹的用户组后，里面新创建的文件是根据创建用户来确定的，譬如root创建了一个文件，那个它的用户组就是root:root,但是这里由于是挂载进去的，所以code下面的文件挂载的时候用户组也变为www-data:www-data。

下面是Nginx的站点配置文件site.conf:

server {
    listen       80;
    server_name  php-docker.local;

    #charset koi8-r;
    #access_log  /var/log/nginx/host.access.log  main;

    #log_format ff '/scripts$fastcgi_script_name > $request';
    #access_log  /var/log/nginx/host.access.log  ff;

    #location / {
    #    root   /code;
    #    index  index.php index.html index.htm;
    #}

    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
    #
    #location ~ \.php$ {
    #    proxy_pass   http://127.0.0.1;
    #}

    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
    #
    location ~ \.php$ {
        root           /code/public/;
        fastcgi_pass   php:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        #fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        include        fastcgi_params;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # deny access to .htaccess files, if Apache's document root
    # concurs with nginx's one
    #
    #location ~ /\.ht {
    #    deny  all;
    #}
}

注意:fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;中变量$document_root对应的就是上面的配置root /code/public/;

这样，我们在团队搭建开发环境的时候，就可以通过上述的配置配置文件实现开发环境的统一，同时由于是在docker中运行，和正式的生产环境非常的类似，简述线上不必要的bug，以及带来交付上的方便。

2.运行镜像

通过上面的配置文件，我们可以很简单的实现开发环境的搭建，现在我们只需要运行下面的命令，整个开发环境就自动搭建起来了:

$ sudo docker-compose up -d

如果希望看到输出调试信息，可以把-d删除，同时也可以通过-f选项选取特定的docker-compose.yml文件:

$ sudo docker-compose -f docker-compose.yml up -d

输出:

3.容器运行过程中的调试技巧

3.1 如何进入运行中的Docker容器

首先要查出容器的的id，可以使用:

$ sudo docker ps

输出:

我们看到my_php的container id是4c1a,可以使用下面命令登陆容器my_php:

$sudo docker exec -it 4c1a bash

3.2 重建docker镜像

有的时候我们修改了Dockerfile,就像我们上面的php文件夹中的Dcokerfile文件，此时我们需要手动的调用镜像重建命令，才能够使docker-compose重新去构建docker镜像:

$sudo docker-compose build

4.配置文件

可以从https://github.com/cloes/php-docker下载到本文使用的配置文件。

转载于:https://my.oschina.net/cloes/blog/3039164