如何使用Docker部署PHP开发环境

本文主要介绍了如何使用docker构建php的开发环境，文中作者也探讨了构建基于docker的开发环境应该使用单容器还是多容器，各有什么利弊。推荐php开发者阅读。希望对大家有所帮助。

 

环境部署一直是一个很大的问题，无论是开发环境还是生产环境，但是 docker 将开发环境和生产环境以轻量级方式打包，提供了一致的环境。极大的提升了开发部署一致性。当然，实际情况并没有这么简单，因为生产环境和开发环境的配置是完全不同的，比如日志等的问题都需要单独配置，但是至少比以前更加简单方便了，这里以 php 开发作为例子讲解 docker 如何布置开发环境。

一般来说，一个 php 项目会需要以下工具：

1. web 服务器: nginx/tengine
2. web 程序: php-fpm
3. 数据库: mysql/postgresql
4. 缓存服务: redis/memcache

这是最简单的架构方式，在 docker 发展早期，docker 被大量的滥用，比如，一个镜像内启动多服务，日志收集依旧是按照 syslog 或者别的老方式，镜像容量非常庞大，基础镜像就能达到 80m，这和 docker 当初提出的思想完全南辕北辙了，而 alpine linux 发行版作为一个轻量级 linux 环境，就非常适合作为 docker 基础镜像，docker 官方也推荐使用 alpine 而不是 debian 作为基础镜像，未来大量的现有官方镜像也将会迁移到 alpine 上。本文所有镜像都将以 alpine 作为基础镜像。

nginx/tengine

这部分笔者已经在另一篇文章 docker 容器的 nginx 实践中讲解了 tengine 的 docker 实践，并且给出了 dockerfile，由于比较偏好 tengine，而且官方已经给出了 nginx 的 alpine 镜像，所以这里就用 tengine。笔者已经将镜像上传到官方 dockerhub，可以通过

<code>docker pull chasontang/tengine:2.1.2_f</code>

获取镜像，具体请看 dockerfile。

php-fpm

docker 官方已经提供了 php 的 7.0.7-fpm-alpine 镜像，dockerfile 如下：

from alpine:3.4

 

# persistent / runtime deps

env phpize_deps \

    autoconf \

    file \

    g++ \

    gcc \

    libc-dev \

    make \

    pkgconf \

    re2c

run apk add --no-cache --virtual .persistent-deps \

    ca-certificates \

    curl

 

# ensure www-data user exists

run set -x \

  && addgroup -g 82 -s www-data \

  && adduser -u 82 -d -s -g www-data www-data

# 82 is the standard uid/gid for "www-data" in alpine

# http://git.alpinelinux.org/cgit/aports/tree/main/apache2/apache2.pre-install?h=v3.3.2

# http://git.alpinelinux.org/cgit/aports/tree/main/lighttpd/lighttpd.pre-install?h=v3.3.2

# http://git.alpinelinux.org/cgit/aports/tree/main/nginx-initscripts/nginx-initscripts.pre-install?h=v3.3.2

 

env php_ini_dir /usr/local/etc/php

run mkdir -p $php_ini_dir/conf.d

 

##<autogenerated>##

env php_extra_configure_args --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data

##</autogenerated>##

 

env gpg_keys 1a4e8b7277c42e53dba9c7b9bcaa30ea9c0d5763

 

env php_version 7.0.7

env php_filename php-7.0.7.tar.xz

env php_sha256 9cc64a7459242c79c10e79d74feaf5bae3541f604966ceb600c3d2e8f5fe4794

 

run set -xe \

  && apk add --no-cache --virtual .build-deps \

    $phpize_deps \

    curl-dev \

    gnupg \

    libedit-dev \

    libxml2-dev \

    openssl-dev \

    sqlite-dev \

  && curl -fsl "http://php.net/get/$php_filename/from/this/mirror" -o "$php_filename" \

  && echo "$php_sha256 *$php_filename" | sha256sum -c - \

  && curl -fsl "http://php.net/get/$php_filename.asc/from/this/mirror" -o "$php_filename.asc" \

  && export gnupghome="$(mktemp -d)" \

  && for key in $gpg_keys; do \

    gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \

  done \

  && gpg --batch --verify "$php_filename.asc" "$php_filename" \

  && rm -r "$gnupghome" "$php_filename.asc" \

  && mkdir -p /usr/src \

  && tar -jxf "$php_filename" -c /usr/src \

  && mv "/usr/src/php-$php_version" /usr/src/php \

  && rm "$php_filename" \

  && cd /usr/src/php \

  && ./configure \

    --with-config-file-path="$php_ini_dir" \

    --with-config-file-scan-dir="$php_ini_dir/conf.d" \

    $php_extra_configure_args \

    --disable-cgi \

# --enable-mysqlnd is included here because it's harder to compile after the fact than extensions are (since it's a plugin for several extensions, not an extension in itself)

    --enable-mysqlnd \

# --enable-mbstring is included here because otherwise there's no way to get pecl to use it properly (see https://github.com/docker-library/php/issues/195)

    --enable-mbstring \

    --with-curl \

    --with-libedit \

    --with-openssl \

    --with-zlib \

  && make -j"$(getconf _nprocessors_onln)" \

  && make install \

  && { find /usr/local/bin /usr/local/sbin -type f -perm +0111 -exec strip --strip-all '{}' + || true; } \

  && make clean \

  && rundeps="$( \

    scanelf --needed --nobanner --recursive /usr/local \

      | awk '{ gsub(/,/, "\nso:", $2); print "so:" $2 }' \

      | sort -u \

      | xargs -r apk info --installed \

      | sort -u \

  )" \

  && apk add --no-cache --virtual .php-rundeps $rundeps \

  && apk del .build-deps

 

copy docker-php-ext-* /usr/local/bin/

 

##<autogenerated>##

workdir /var/www/html

 

run set -ex \

  && cd /usr/local/etc \

  && if [ -d php-fpm.d ]; then \

    # for some reason, upstream's php-fpm.conf.default has "include=none/etc/php-fpm.d/*.conf"

    sed 's!=none/!=!g' php-fpm.conf.default | tee php-fpm.conf > /dev/null; \

    cp php-fpm.d/www.conf.default php-fpm.d/www.conf; \

  else \

    # php 5.x don't use "include=" by default, so we'll create our own simple config that mimics php 7+ for consistency

    mkdir php-fpm.d; \

    cp php-fpm.conf.default php-fpm.d/www.conf; \

    { \

      echo '[global]'; \

      echo 'include=etc/php-fpm.d/*.conf'; \

    } | tee php-fpm.conf; \

  fi \

  && { \

    echo '[global]'; \

    echo 'error_log = /proc/self/fd/2'; \

    echo; \

    echo '[www]'; \

    echo '; if we send this to /proc/self/fd/1, it never appears'; \

    echo 'access.log = /proc/self/fd/2'; \

    echo; \

    echo 'clear_env = no'; \

    echo; \

    echo '; ensure worker stdout and stderr are sent to the main error log.'; \

    echo 'catch_workers_output = yes'; \

  } | tee php-fpm.d/docker.conf \

  && { \

    echo '[global]'; \

    echo 'daemonize = no'; \

    echo; \

    echo '[www]'; \

    echo 'listen = [::]:9000'; \

  } | tee php-fpm.d/zz-docker.conf

 

expose 9000

cmd ["php-fpm"]

##</autogenerated>##

首先，镜像继承自 alpine:3.4 镜像，使用 apk 命令安装 php 最小依赖，同时添加 www-data 作为 php-fpm 的运行用户，将 php 的配置文件指定到 /usr/local/etc/php，然后就是下载 php-src，编译安装，这里可以参考笔者之前写的 php 编译安装文章。参数都中规中矩。安装目录被指定到 /usr/local，然后使用 scanelf 获得所依赖的运行库列表，并且将其他安装包删除。将 docker-php-ext-configure、docker-php-ext-enable、docker-php-ext-install 复制到容器中，这三个文件用于后续安装扩展。然后将 php-fpm.conf 复制到配置目录，将 error_log 和 access_log 指定到终端标准输出，daemonize = no 表示不以服务进程运行。expose 9000 端口用于和其他容器通信，然后就是 cmd ["php-fpm"] 运行 php-fpm。而且工作目录被指定到 /var/www/html。

docker-compose

已经搞定了基础镜像，我们就可以使用基础镜像来配置容器，但是通过手工 docker 命令启动容器会非常麻烦。但是万幸的是官方已经提供了 docker-compose 命令来编排容器，只需要写一个 docker-compose.yaml 文件就行，具体可以参考官方文档。

version: '2'

services:

 php-fpm:

  image: php:7.0.7-fpm-alpine

  volumes:

   - "./src:/var/www/html"

  restart: always

 

 tengine:

  depends_on:

   - php-fpm

  links:

   - php-fpm

  image: chasontang/tengine:2.1.2_f

  volumes:

   - "./nginx.vh.default.conf:/etc/nginx/conf.d/default.conf"

  ports:

   - "80:80"

  restart: always

非常容易理解，这里定义了两个服务，php-fpm 依赖 php:7.0.7-fpm-alpine 镜像，并且将 src 文件夹映射为 /var/www/html 文件夹，tengine 服务依赖 php-fpm 服务，并且 link php-fpm 服务，这样就能通过网络与 php-fpm 容器通信，tengine 服务基于 chasontang/tengine:2.1.2_f 镜像，并将 nginx.vh.default.conf 文件映射为 /etc/nginx/conf.d/default.conf 文件。然后来看 nginx.vh.default.conf

server {

  listen    80;

  server_name localhost;

 

  #charset koi8-r;

 

  #access_log logs/host.access.log main;

 

  location / {

    root  html;

    index 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  html;

  }

 

  # proxy the php scripts to apache listening on 127.0.0.1:80

  #

  #location ~ \.php$ {

  #  proxy_pass  http://127.0.0.1;

  #}

 

  location ~ [^/]\.php(/|$) {

    fastcgi_split_path_info ^(.+?\.php)(/.*)$;

    fastcgi_pass php-fpm:9000;

    fastcgi_index index.php;

    fastcgi_param script_filename /var/www/html$fastcgi_script_name;

    fastcgi_param path_info $fastcgi_path_info;

    include fastcgi_params;

  }

 

  # deny access to .htaccess files, if apache's document root

  # concurs with nginx's one

  #

  #location ~ /\.ht {

  #  deny all;

  #}

}

的所有文件，因为 /etc/nginx/nginx.conf 中使用 include /etc/nginx/conf.d/*.conf; 包含了这个目录，也就是说，可以不需要去管 nginx 其他配置，只需要用自己的 nginx 虚拟主机配置替代默认的虚拟主机配置，或者说增加虚拟主机配置就行了。

从上面可以看到，default.conf 文件定义了一个 location 匹配包含 .php 的 url，然后将其分割出 path_info 参数，将这些变量传递给 php-fpm:9000 的 php-fpm 服务。

这里需要注意的是，由于 nginx 和 php-fpm 不在同一台主机上，所以 nginx 只做静态文件处理和路由转发，实际的 php 文件执行时在 php-fpm 容器中发生的。所以 script_filename 变量必须要使用 php-fpm 容器中的目录，所以这里使用硬编码指定。当然，也可以让两个容器共享同一个数据卷，但是笔者认为，这只是为了方便容器编排，其他完全没有好处。

很容易吧！ 现在我们可以快速的启动、更新环境了。

以上就是如何使用docker部署php开发环境的详细内容

以上内容希望帮助到大家，很多phper在进阶的时候总会遇到一些问题和瓶颈，业务代码写多了没有方向感，不知道该从那里入手去提升，对此我整理了一些资料，包括但不限于：分布式架构、高可扩展、高性能、高并发、服务器性能调优、tp6，laravel，yii2，redis，swoole、swoft、kafka、mysql优化、shell脚本、docker、微服务、nginx等多个知识点高级进阶干货需要的可以免费分享给大家，需要的可以加入我的官方群点击此处。