当前位置:首页 > PHP教程 > php环境安装 > 列表

使用Docker部署PHP开发环境的方法详解

发布:smiling 来源: PHP粉丝网  添加日期:2022-05-27 13:07:11 浏览: 评论:0 

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

环境部署一直是一个很大的问题,无论是开发环境还是生产环境,但是 Docker 将开发环境和生产环境以轻量级方式打包,提供了一致的环境。极大的提升了开发部署一致性。

当然,实际情况并没有这么简单,因为生产环境和开发环境的配置是完全不同的,比如日志等的问题都需要单独配置,但是至少比以前更加简单方便了,这里以 PHP 开发作为例子讲解 Docker 如何布置开发环境。

一般来说,一个 PHP 项目会需要以下工具:

Web 服务器: Nginx/Tengine

Web 程序: PHP-FPM

数据库: MySQL/PostgreSQL

缓存服务: 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 如下:

  1. FROM alpine:3.4 
  2.  
  3.    
  4.  
  5. # persistent / runtime deps 
  6.  
  7. ENV PHPIZE_DEPS \ 
  8.  
  9.     autoconf \ 
  10.  
  11.     file \ 
  12.  
  13.     g++ \ 
  14.  
  15.     gcc \ 
  16.  
  17.     libc-dev \ 
  18.  
  19.     make \ 
  20.  
  21.     pkgconf \ 
  22.  
  23.     re2c 
  24.  
  25. RUN apk add --no-cache --virtual .persistent-deps \ 
  26.  
  27.     ca-certificates \ 
  28.  
  29.     curl 
  30.  
  31.    
  32.  
  33. # ensure www-data user exists 
  34.  
  35. RUN set -x \ 
  36.  
  37.   && addgroup -g 82 -S www-data \ 
  38.  
  39.   && adduser -u 82 -D -S -G www-data www-data 
  40.  
  41. # 82 is the standard uid/gid for "www-data" in Alpine 
  42.  
  43. # http://git.alpinelinux.org/cgit/aports/tree/main/apache2/apache2.pre-install?h=v3.3.2 
  44.  
  45. # http://git.alpinelinux.org/cgit/aports/tree/main/lighttpd/lighttpd.pre-install?h=v3.3.2 
  46.  
  47. # http://git.alpinelinux.org/cgit/aports/tree/main/nginx-initscripts/nginx-initscripts.pre-install?h=v3.3.2 
  48.  
  49.    
  50.  
  51. ENV PHP_INI_DIR /usr/local/etc/php 
  52.  
  53. RUN mkdir -p $PHP_INI_DIR/conf.d 
  54.  
  55.    
  56.  
  57. ##<autogenerated>## 
  58.  
  59. ENV PHP_EXTRA_CONFIGURE_ARGS --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data 
  60.  
  61. ##</autogenerated>## 
  62.  
  63.    
  64.  
  65. ENV GPG_KEYS 1A4E8B7277C42E53DBA9C7B9BCAA30EA9C0D5763 
  66.  
  67.    
  68.  
  69. ENV PHP_VERSION 7.0.7 
  70.  
  71. ENV PHP_FILENAME php-7.0.7.tar.xz 
  72.  
  73. ENV PHP_SHA256 9cc64a7459242c79c10e79d74feaf5bae3541f604966ceb600c3d2e8f5fe4794 
  74.  
  75.    
  76.  
  77. RUN set -xe \ 
  78.  
  79.   && apk add --no-cache --virtual .build-deps \ 
  80.  
  81.     $PHPIZE_DEPS \ 
  82.  
  83.     curl-dev \ 
  84.  
  85.     gnupg \ 
  86.  
  87.     libedit-dev \ 
  88.  
  89.     libxml2-dev \ 
  90.  
  91.     openssl-dev \ 
  92.  
  93.     sqlite-dev \ 
  94.  
  95.   && curl -fSL "http://php.net/get/$PHP_FILENAME/from/this/mirror" -o "$PHP_FILENAME" \ 
  96.  
  97.   && echo "$PHP_SHA256 *$PHP_FILENAME" | sha256sum -c - \ 
  98.  
  99.   && curl -fSL "http://php.net/get/$PHP_FILENAME.asc/from/this/mirror" -o "$PHP_FILENAME.asc" \ 
  100.  
  101.   && export GNUPGHOME="$(mktemp -d)" \ 
  102.  
  103.   && for key in $GPG_KEYSdo \ 
  104.  
  105.     gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \ 
  106.  
  107.   done \ 
  108.  
  109.   && gpg --batch --verify "$PHP_FILENAME.asc" "$PHP_FILENAME" \ 
  110.  
  111.   && rm -r "$GNUPGHOME" "$PHP_FILENAME.asc" \ 
  112.  
  113.   && mkdir -p /usr/src \ 
  114.  
  115.   && tar -Jxf "$PHP_FILENAME" -C /usr/src \ 
  116.  
  117.   && mv "/usr/src/php-$PHP_VERSION" /usr/src/php \ 
  118.  
  119.   && rm "$PHP_FILENAME" \ 
  120.  
  121.   && cd /usr/src/php \ 
  122.  
  123.   && ./configure \ 
  124.  
  125.     --with-config-file-path="$PHP_INI_DIR" \ 
  126.  
  127.     --with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \ 
  128.  
  129.     $PHP_EXTRA_CONFIGURE_ARGS \ 
  130.  
  131.     --disable-cgi \ 
  132.  
  133. # --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) 
  134.  
  135.     --enable-mysqlnd \ 
  136.  
  137. # --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) 
  138.  
  139.     --enable-mbstring \ 
  140.  
  141.     --with-curl \ 
  142.  
  143.     --with-libedit \ 
  144.  
  145.     --with-openssl \ 
  146.  
  147.     --with-zlib \ 
  148.  
  149.   && make -j"$(getconf _NPROCESSORS_ONLN)" \ 
  150.  
  151.   && make install \ 
  152.  
  153.   && { find /usr/local/bin /usr/local/sbin -type f -perm +0111 -exec strip --strip-all '{}' + || true; } \ 
  154.  
  155.   && make clean \ 
  156.  
  157.   && runDeps="$( \ 
  158.  
  159.     scanelf --needed --nobanner --recursive /usr/local \ 
  160.  
  161.       | awk '{ gsub(/,/, "\nso:", $2); print "so:" $2 }' \ 
  162.  
  163.       | sort -u \ 
  164.  
  165.       | xargs -r apk info --installed \ 
  166.  
  167.       | sort -u \ 
  168.  
  169.   )" \ 
  170.  
  171.   && apk add --no-cache --virtual .php-rundeps $runDeps \ 
  172.  
  173.   && apk del .build-deps 
  174.  
  175.    
  176.  
  177. COPY docker-php-ext-* /usr/local/bin/ 
  178.  
  179.    
  180.  
  181. ##<autogenerated>## 
  182.  
  183. WORKDIR /var/www/html 
  184.  
  185.    
  186.  
  187. RUN set -ex \ 
  188.  
  189.   && cd /usr/local/etc \ 
  190.  
  191.   && if [ -d php-fpm.d ]; then \ 
  192.  
  193.     # for some reason, upstream's php-fpm.conf.default has "include=NONE/etc/php-fpm.d/*.conf" 
  194.  
  195.     sed 's!=NONE/!=!g' php-fpm.conf.default | tee php-fpm.conf > /dev/null; \ 
  196.  
  197.     cp php-fpm.d/www.conf.default php-fpm.d/www.conf; \ 
  198.  
  199.   else \ 
  200.  
  201.     # PHP 5.x don't use "include=" by default, so we'll create our own simple config that mimics PHP 7+ for consistency 
  202.  
  203.     mkdir php-fpm.d; \ 
  204.  
  205.     cp php-fpm.conf.default php-fpm.d/www.conf; \ 
  206.  
  207.     { \ 
  208.  
  209.       echo '[global]'; \ 
  210.  
  211.       echo 'include=etc/php-fpm.d/*.conf'; \ 
  212.  
  213.     } | tee php-fpm.conf; \ 
  214.  
  215.   fi \ 
  216.  
  217.   && { \ 
  218.  
  219.     echo '[global]'; \ 
  220.  
  221.     echo 'error_log = /proc/self/fd/2'; \ 
  222.  
  223.     echo; \ 
  224.  
  225.     echo '[www]'; \ 
  226.  
  227.     echo '; if we send this to /proc/self/fd/1, it never appears'; \ 
  228.  
  229.     echo 'access.log = /proc/self/fd/2'; \ 
  230.  
  231.     echo; \ 
  232.  
  233.     echo 'clear_env = no'; \ 
  234.  
  235.     echo; \ 
  236.  
  237.     echo '; Ensure worker stdout and stderr are sent to the main error log.'; \ 
  238.  
  239.     echo 'catch_workers_output = yes'; \ 
  240.  
  241.   } | tee php-fpm.d/docker.conf \ 
  242.  
  243.   && { \ 
  244.  
  245.     echo '[global]'; \ 
  246.  
  247.     echo 'daemonize = no'; \ 
  248.  
  249.     echo; \ 
  250.  
  251.     echo '[www]'; \ 
  252.  
  253.     echo 'listen = [::]:9000'; \ 
  254.  
  255.   } | tee php-fpm.d/zz-docker.conf 
  256.  
  257.    
  258.  
  259. EXPOSE 9000 
  260.  
  261. CMD ["php-fpm"
  262.  
  263. ##</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 文件就行,具体可以参考官方文档。

  1. version: '2' 
  2.  
  3. services: 
  4.  
  5.  php-fpm: 
  6.  
  7.   image: php:7.0.7-fpm-alpine 
  8.  
  9.   volumes: 
  10.  
  11.    - "./src:/var/www/html" 
  12.  
  13.   restart: always 
  14.  
  15.    
  16.  
  17.  tengine: 
  18.  
  19.   depends_on: 
  20.  
  21.    - php-fpm 
  22.  
  23.   links: 
  24.  
  25.    - php-fpm 
  26.  
  27.   image: chasontang/tengine:2.1.2_f 
  28.  
  29.   volumes: 
  30.  
  31.    - "./nginx.vh.default.conf:/etc/nginx/conf.d/default.conf" 
  32.  
  33.   ports: 
  34.  
  35.    - "80:80" 
  36.  
  37.   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

  1. server { 
  2.  
  3.   listen    80; 
  4.  
  5.   server_name localhost; 
  6.  
  7.    
  8.  
  9.   #charset koi8-r; 
  10.  
  11.    
  12.  
  13.   #access_log logs/host.access.log main; 
  14.  
  15.    
  16.  
  17.   location / { 
  18.  
  19.     root  html; 
  20.  
  21.     index index.html index.htm; 
  22.  
  23.   } 
  24.  
  25.    
  26.  
  27.   #error_page 404       /404.html; 
  28.  
  29.    
  30.  
  31.   # redirect server error pages to the static page /50x.html 
  32.  
  33.   # 
  34.  
  35.   error_page  500 502 503 504 /50x.html; 
  36.  
  37.   location = /50x.html { 
  38.  
  39.     root  html; 
  40.  
  41.   } 
  42.  
  43.    
  44.  
  45.   # proxy the PHP scripts to Apache listening on 127.0.0.1:80 
  46.  
  47.   # 
  48.  
  49.   #location ~ \.php$ { 
  50.  
  51.   #  proxy_pass  http://127.0.0.1; 
  52.  
  53.   #} 
  54.  
  55.    
  56.  
  57.   location ~ [^/]\.php(/|$) { 
  58.  
  59.     fastcgi_split_path_info ^(.+?\.php)(/.*)$; 
  60.  
  61.     fastcgi_pass php-fpm:9000; 
  62.  
  63.     fastcgi_index index.php; 
  64.  
  65.     fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name; 
  66.  
  67.     fastcgi_param PATH_INFO $fastcgi_path_info; 
  68.  
  69.     include fastcgi_params; 
  70.  
  71.   } 
  72.  
  73.    
  74.  
  75.   # deny access to .htaccess files, if Apache's document root 
  76.  
  77.   # concurs with nginx's one 
  78.  
  79.   # 
  80.  
  81.   #location ~ /\.ht { 
  82.  
  83.   #  deny all; 
  84.  
  85.   #} 
  86.  

的所有文件,因为 /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 容器中的目录,所以这里使用硬编码指定。当然,也可以让两个容器共享同一个数据卷,但是笔者认为,这只是为了方便容器编排,其他完全没有好处。

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

Tags: Docker PHP开发环境

分享到: