Docker Compose:创建本地开发 PHP 应用的环境

定义了下面这些服务:

    ◆ db:使用 mariadb 作为应用的数据库
    ◆ php:解释 php 脚本,使用 php-fpm
    ◆ web:使用 NGINX 作为应用的 web 服务器
    ◆ console:常用工具
    ◆ redis:缓存
    ◆ phpmyadmin:管理数据库的 web 界面

准备

在本地安装 Docker for Mac 或 Docker for Windows ,然后启动 docker ,再打开你喜爱的文本编辑器与命令行工具。为项目创建一个目录,在根目录下创建一个 docker-compose.yml 文件。

 
cd ~/desktop
mkdir nest
cd nest
atom docker-compose.yml

目录结构

你可以按自己的喜好组织项目,下面是我用的方法,app 目录放的是应用的代码,services 下面是创建服务需要用的东西,有些服务需要我们自己去创建镜像,在一个 Dockerfile 文件里说明一下你想要的镜像是什么样的。在创建自定义镜像的时候也可能需要用到一些额外的文件,比如一些配置文件,一般在创建镜像的时候会把这些配置文件复制到镜像里。

 
├── app
│   ├── index.html
│   └── phpinfo.php
├── docker-compose.yml
└── services
    ├── console
    │   ├── Dockerfile
    │   └── composer-1.1.3.phar
    ├── web
    │   └── config
    │       └── default.conf
    └── php
        ├── Dockerfile
        └── config
            ├── opcache-recommended.ini
            └── php.ini

Compose 文件

Compose 文件用的是 yaml 格式,文件一开始说明一下使用的 compose 版本,这个文件分成三个主要部分,services(服务),networks(网络),volumes (数据卷)。在这三部分主要的部分下面列出你需要的东西,docker 会自动为 compose 的项目创建一个默认的网络,你可以添加自己想要的网络,然后分配给指定的服务使用。在 volumes 下可以列出创建的数据卷,在定义服务的时候,你可以指定使用的数据卷,还有它对应的要挂载到的容器里的位置。

 
version: '2'

services:
# 定义的服务

networks:
# 服务需要用的网络

volumes:
# 服务需要用的数据卷

db

db 是数据服务,我打算用 mariadb ,先去给这个服务添加一个数据卷,然后在这个服务里使用一下这个数据卷,把数据库生成的数据放到这里,这样即使我们删除容器,数据服务里的数据也会保留在主机上,下回创建容器的时候,可以继续使用已有的数据。在 volumes 下面,添加一个名字是 db 的数据卷:

 
services:
# ...

volumes:
 db:
   driver: local

然后再去添加一个名字是 db 的服务,指定一下服务使用的镜像,这个镜像我们也可以用自己创建的 Dockerfile 去创建一下,或者你不打算定制镜像,也可以直接使用现成的,这里我用了 mariadb:10.1 这个镜像。注意最好设置具体要使用的版本。

这个镜像里有一些环境变量,我们可以在定义服务的时候去设置一下它们的值,这里我设置了 root 用户的密码,要创建的数据库,用户名,还有密码,你可以 根据自己的需求去修改这些变量的值。

在 db 服务上我用了 volumes 为它指定了一个 db 数据卷,挂载的位置是容器的 /var/lib/mysql ,这是存储数据库的默认的地方。

 
services:
  db:
    image: mariadb:10.1
    environment:
      MYSQL_ROOT_PASSWORD: "root"
      MYSQL_DATABASE: "app"
      MYSQL_USER: "app"
      MYSQL_PASSWORD: "123123"
    volumes:
      - db:/var/lib/mysql

测试

在我们的 compose 文件里现在已经有了一个叫 db 的服务,在命令行工具下,进入到项目所在的目录,执行:

 
docker-compose up -d

Docker 会按照 compose 文件里的指示,创建应用需要的网络,数据卷,还有一个名字是 db 的数据服务,你可以进入到这个服务容器里看一下:

 
docker-compose exec db bash

进入以后使用 mysql 登录到数据库检查一下:

 
mysql -u root -p
# 输入 root 用户密码,密码是在定义 db 服务的时候使用 MYSQL_ROOT_PASSWORD 变量设置的。

show databases;
# 你能看到一个名字是 app 的数据库,这个数据库是在定义 db 服务的时候使用 MYSQL_DATABASE 变量设置的。

php

定义一个解释 php 的服务,我打算自己创建这个服务用的镜像,所以用了 build,而不是 image 。我告诉了 docker 自己要创建的这个镜像要使用的那个 Dockerfile 文件的位置(./services/php/Dockerfile)。

volumes 下面是服务用的数据卷,我把 compose 文件所在目录下的 app 这个目录,挂载到了容器的 /mnt/app 这个位置上了。这样我可以直接修改项目的代码,然后立即看到结果。

 
services:
  db:
  # ...
  php:
    build:
      context: ./services/php
      dockerfile: Dockerfile
    volumes:
      - ./app:/mnt/app

Dockerfile

构建 php 服务的镜像用的 Dockerfile 是 ./services/php/Dockerfile。FROM,设置了一下这个镜像要基于哪个镜像去创建,我用了 php:7.0-fpm 这个官方提供的镜像。MAINTAINER 设置了一下维护的作者。RUN 了几行命令,主要是去安装一些软件包,比如一些额外的 php 扩展。在安装这些扩展之前 ,你需要先安装扩展依赖的一些其它的软件包,这里的 libpng12-dev,libjpeg-dev,就是 gd 这个 php 扩展需要的软件包。然后我又 COPY 了两个配置文件到镜像里面。

 
FROM php:7.0-fpm
MAINTAINER wanghao 

RUN apt-get update && apt-get install -y libpng12-dev libjpeg-dev \
  && rm -rf /var/lib/apt/lists/* \
  && docker-php-ext-configure gd --with-png-dir=/usr --with-jpeg-dir=/usr \
  && docker-php-ext-install gd mysqli pdo_mysql zip opcache

COPY ./config/php.ini /usr/local/etc/php/conf.d/
COPY ./config/opcache-recommended.ini /usr/local/etc/php/conf.d/

php.ini

自定义的 php 配置。把你想要的 php 配置放到这个文件里,重新 build 镜像,然后再次启动 php 服务的时候会用新的镜像重新创建容器,这样配置就会生效了。

 
memory_limit = 256M
post_max_size = 100M
upload_max_filesize = 100M

opcache-recommended.ini

这是 php 的 opcache 扩展的配置文件。我发现在开发 WordPress 的时候,如果使用了 opcache ,修改代码以后并不能立即看到结果。所以在开发阶段可以关掉 opcache 功能,在生产环境打开它,会提高代码的执行效率。

 
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.revalidate_freq=60
opcache.fast_shutdown=1
opcache.enable_cli=1
# 关闭 opcache 可以让 opcache.enable=0,打开 opcache 可以让 opcache.enable=1
# 在开发应用的时候可以关掉 opcache 。
opcache.enable=0

web

web 服务我打算用 nginx ,用 image 指定了要使用的镜像,ports 设置了发布的端口号,让主机上的 8080 对应容器的 80 。depends_on 可以设置服务的依赖,我让 web 服务依赖之前定义的 php ,这样会先启动 php ,然后再启动 web 。volumes_from 设置了让这个 web 服务使用在 php 服务里定义的数据卷。

另外我又用了 volumes 自己设置了一个数据卷,让主机上包含 nginx 配置文件的目录,对应容器里的 nginx 服务的配置文件目录,这样我就可以直接在本机上修改 nginx 的配置文件,然后重新启动一下 web 服务,配置就可以生效了。这种方法适用在开发环境上,因为修改了配置不需要重新 build 镜像,在生产环境中,你需要自己 build 这个 nginx 镜像,把想要的配置直接复制到镜像里去。

 
services:
  db:
  # ...
  php:
  # ...
  web:
    image: nginx:1.11.1
    ports:
      - "8080:80"
    depends_on:
      - php
    volumes_from:
      - php
    volumes:
      - ./images/nginx/config:/etc/nginx/conf.d

default.conf

./images/nginx/config/default.conf,这是一个最基本的 nginx 配置文件,设置了应用的 root 是在 /mnt/app 这里,我们已经把主机上的 app 目录挂载到了容器里的 /mnt/app 这个地方。

注意这条指令:fastcgi_pass php:9000; 这里的 php 是我们定义的 php 这个服务的名字,在 compose 文件里定义的服务,它们之间可以使用服务的名字相互进行沟通,因为 docker 内置了 DNS 功能。

 
server {
  listen       80;
  server_name  localhost;
  root          /mnt/app;
  index         index.php index.html index.htm;

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

  location ~ \.php$ {
     fastcgi_pass   php:9000;
     fastcgi_index  index.php;
     fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
     include        fastcgi_params;
  }
}

console

在开发应用的时候还会用到一些小工具,比如 php 包管理 composer ,WordPress 项目管理 wp-cli,Drupal 项目管理 drush 等等。我想把它们单独放到一个服务里面,这个服务用的镜像我需要自己去创建。

 
services:
  db:
  # ...
  php:
  # ...
  web:
  # ...  
  console:
    build:
      context: ./images/console
      dockerfile: Dockerfile
    volumes_from:
      - php
    tty: true

Dockerfile

./services/console/Dockerfile,这是为 console 服务准备的创建镜像用的文件。

 
FROM php:7.0
MAINTAINER wanghao 

WORKDIR /mnt/app

# 常用工具
RUN apt-get update && apt-get install -y git curl wget cron vim locales libfreetype6-dev mariadb-client \
  && rm -rf /var/lib/apt/lists/* \
  && pecl install zip \
  && docker-php-ext-enable zip \
  && docker-php-ext-install mysqli pdo_mysql

# 把语言设置成简体中文
RUN dpkg-reconfigure locales && \
  locale-gen C.UTF-8 && \
  /usr/sbin/update-locale LANG=C.UTF-8
RUN echo 'zh_CN.UTF-8 UTF-8' >> /etc/locale.gen && \
  locale-gen
ENV LC_ALL C.UTF-8
ENV LANG zh_CN.UTF-8
ENV LANGUAGE zh_CN.UTF-8

# 配置 git
RUN git config --global user.name "wanghao8080" \
  && git config --global user.email "[email protected]"

# 安装与配置 composer
# Composer 官方安装脚本 https://getcomposer.org/download/
# 因为在国内下载 composer 太慢,我们直接把下载下来的 composer 复制到容器里使用。
COPY ./composer-1.1.3.phar /usr/local/bin/composer
RUN chmod +x /usr/local/bin/composer
RUN echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc \
  && . ~/.bashrc \
  && composer config -g repo.packagist composer https://packagist.phpcomposer.com

# 安装管理 WordPress 项目的 wp-cli
RUN curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar \
  && chmod +x wp-cli.phar \
  && mv wp-cli.phar /usr/local/bin/wp

# 安装管理 Drupal 项目的 drush
RUN php -r "readfile('http://files.drush.org/drush.phar');" > drush \
  && chmod +x drush \
  && mv drush /usr/local/bin

redis

redis 服务可以当缓存用,WordPress,Drupal,Laravel 这些应用都会用到它。定义这个服务只是简单的用了一个官方的镜像,设置了一个公布的端口号。

 
services:
  db:
  # ...
  php:
  # ...
  web:
  # ...  
  console:
  # ...
  redis:
    image: redis:3.2.1
    ports:
      - "6379:6379"

phpredis

我打算配置 Drupal 8 使用 Redis,除了需要 redis 服务以外,我还需要安装 phpredis 这个 php 扩展。打开创建 php 服务镜像用的 Dockerfile(./services/php/Dockerfile),下面这段代码是去下载指定版本的 phpredis 扩展:

 
ENV PHPREDIS_VERSION 3.0.0
RUN curl -L -o /tmp/redis.tar.gz https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz \
 && tar xfz /tmp/redis.tar.gz \
 && rm -r /tmp/redis.tar.gz \
 && mv phpredis-$PHPREDIS_VERSION /usr/src/php/ext/redis

然后再用 php 官方镜像里的 docker-php-ext-install 这个脚本去安装 php 扩展:

 
&& docker-php-ext-install ... redis

现在这个 Dockerfile 看起来是这样的:

 
FROM php:7.0-fpm
MAINTAINER wanghao 

ENV PHPREDIS_VERSION 3.0.0
RUN curl -L -o /tmp/redis.tar.gz https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz \
 && tar xfz /tmp/redis.tar.gz \
 && rm -r /tmp/redis.tar.gz \
 && mv phpredis-$PHPREDIS_VERSION /usr/src/php/ext/redis

RUN apt-get update && apt-get install -y libpng12-dev libjpeg-dev \
 && rm -rf /var/lib/apt/lists/* \
 && docker-php-ext-configure gd --with-png-dir=/usr --with-jpeg-dir=/usr \
 && docker-php-ext-install gd mysqli pdo_mysql zip opcache redis


COPY ./config/php.ini /usr/local/etc/php/conf.d/
COPY ./config/opcache-recommended.ini /usr/local/etc/php/conf.d/

phpredis

phpmyadmin 是管理 mysql 或 mariadb 数据库的 web 界面。这个服务用了 phpmyadmin/phpmyadmin 这个镜像,发布了端口,让主机的 8081 对应容器的 80 端口,这样访问 主机:8081 的时候就会打开这个管理数据库的 web 界面,镜像里设置了一些环境变量,在这个服务里用了一些,主要是告诉 phpmyadmin 数据库的主机是谁,管理数据库使用的用户是谁,密码是什么。

 
services:
  db:
  # ...
  php:
  # ...
  web:
  # ...  
  console:
  # ...
  redis:
  # ...
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    ports:
      - "8081:80"
    environment:
      PMA_HOST: "db"
      PMA_USER: "root"
      PMA_PASSWORD: "root"

启动

在 app 目录下创建一个 phpinfo.php ,内容是:

  1. <?php phpinfo(); ?>

进入到项目下面,执行:

 
docker-compose up -d

打开浏览器,访问:

 
http://localhost:8080/phpinfo.php

你会看到 php 信息页面。

版权

1、本文作者:王皓

2、更多视频教程关注 ninghao.net


发布日期:

所属分类: Php 标签: