php教程分享

  1. php教程首页
  2. php环境搭建

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

•php环境搭建•阅读 453

本文主要介绍了如何使用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. # persistent / runtime deps
  3. ENV PHPIZE_DEPS \
  4. autoconf \
  5. file \
  6. g++ \
  7. gcc \
  8. libc-dev \
  9. make \
  10. pkgconf \
  11. re2c
  12. RUN apk add --no-cache --virtual .persistent-deps \
  13. ca-certificates \
  14. curl
  15. # ensure www-data user exists
  16. RUN set -x \
  17. && addgroup -g 82 -S www-data \
  18. && adduser -u 82 -D -S -G www-data www-data
  19. # 82 is the standard uid/gid for "www-data" in Alpine
  20. # http://git.alpinelinux.org/cgit/aports/tree/main/apache2/apache2.pre-install?h=v3.3.2
  21. # http://git.alpinelinux.org/cgit/aports/tree/main/lighttpd/lighttpd.pre-install?h=v3.3.2
  22. # http://git.alpinelinux.org/cgit/aports/tree/main/nginx-initscripts/nginx-initscripts.pre-install?h=v3.3.2
  23. ENV PHP_INI_DIR /usr/local/etc/php
  24. RUN mkdir -p $PHP_INI_DIR/conf.d
  25. ##<autogenerated>##
  26. ENV PHP_EXTRA_CONFIGURE_ARGS --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data
  27. ##</autogenerated>##
  28. ENV GPG_KEYS 1A4E8B7277C42E53DBA9C7B9BCAA30EA9C0D5763
  29. ENV PHP_VERSION 7.0.7
  30. ENV PHP_FILENAME php-7.0.7.tar.xz
  31. ENV PHP_SHA256 9cc64a7459242c79c10e79d74feaf5bae3541f604966ceb600c3d2e8f5fe4794
  32. RUN set -xe \
  33. && apk add --no-cache --virtual .build-deps \
  34. $PHPIZE_DEPS \
  35. curl-dev \
  36. gnupg \
  37. libedit-dev \
  38. libxml2-dev \
  39. openssl-dev \
  40. sqlite-dev \
  41. && curl -fSL "http://php.net/get/$PHP_FILENAME/from/this/mirror" -o "$PHP_FILENAME" \
  42. && echo "$PHP_SHA256 *$PHP_FILENAME" | sha256sum -c - \
  43. && curl -fSL "http://php.net/get/$PHP_FILENAME.asc/from/this/mirror" -o "$PHP_FILENAME.asc" \
  44. && export GNUPGHOME="$(mktemp -d)" \
  45. && for key in $GPG_KEYS; do \
  46. gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \
  47. done \
  48. && gpg --batch --verify "$PHP_FILENAME.asc" "$PHP_FILENAME" \
  49. && rm -r "$GNUPGHOME" "$PHP_FILENAME.asc" \
  50. && mkdir -p /usr/src \
  51. && tar -Jxf "$PHP_FILENAME" -C /usr/src \
  52. && mv "/usr/src/php-$PHP_VERSION" /usr/src/php \
  53. && rm "$PHP_FILENAME" \
  54. && cd /usr/src/php \
  55. && ./configure \
  56. --with-config-file-path="$PHP_INI_DIR" \
  57. --with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \
  58. $PHP_EXTRA_CONFIGURE_ARGS \
  59. --disable-cgi \
  60. # --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)
  61. --enable-mysqlnd \
  62. # --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)
  63. --enable-mbstring \
  64. --with-curl \
  65. --with-libedit \
  66. --with-openssl \
  67. --with-zlib \
  68. && make -j"$(getconf _NPROCESSORS_ONLN)" \
  69. && make install \
  70. && { find /usr/local/bin /usr/local/sbin -type f -perm +0111 -exec strip --strip-all '{}' + || true; } \
  71. && make clean \
  72. && runDeps="$( \
  73. scanelf --needed --nobanner --recursive /usr/local \
  74. | awk '{ gsub(/,/, "\nso:", $2); print "so:" $2 }' \
  75. | sort -u \
  76. | xargs -r apk info --installed \
  77. | sort -u \
  78. )" \
  79. && apk add --no-cache --virtual .php-rundeps $runDeps \
  80. && apk del .build-deps
  81. COPY docker-php-ext-* /usr/local/bin/
  82. ##<autogenerated>##
  83. WORKDIR /var/www/html
  84. RUN set -ex \
  85. && cd /usr/local/etc \
  86. && if [ -d php-fpm.d ]; then \
  87. # for some reason, upstream's php-fpm.conf.default has "include=NONE/etc/php-fpm.d/*.conf"
  88. sed 's!=NONE/!=!g' php-fpm.conf.default | tee php-fpm.conf > /dev/null; \
  89. cp php-fpm.d/www.conf.default php-fpm.d/www.conf; \
  90. else \
  91. # PHP 5.x don't use "include=" by default, so we'll create our own simple config that mimics PHP 7+ for consistency
  92. mkdir php-fpm.d; \
  93. cp php-fpm.conf.default php-fpm.d/www.conf; \
  94. { \
  95. echo '[global]'; \
  96. echo 'include=etc/php-fpm.d/*.conf'; \
  97. } | tee php-fpm.conf; \
  98. fi \
  99. && { \
  100. echo '[global]'; \
  101. echo 'error_log = /proc/self/fd/2'; \
  102. echo; \
  103. echo '[www]'; \
  104. echo '; if we send this to /proc/self/fd/1, it never appears'; \
  105. echo 'access.log = /proc/self/fd/2'; \
  106. echo; \
  107. echo 'clear_env = no'; \
  108. echo; \
  109. echo '; Ensure worker stdout and stderr are sent to the main error log.'; \
  110. echo 'catch_workers_output = yes'; \
  111. } | tee php-fpm.d/docker.conf \
  112. && { \
  113. echo '[global]'; \
  114. echo 'daemonize = no'; \
  115. echo; \
  116. echo '[www]'; \
  117. echo 'listen = [::]:9000'; \
  118. } | tee php-fpm.d/zz-docker.conf
  119. EXPOSE 9000
  120. CMD ["php-fpm"]
  121. ##</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. services:
  3. php-fpm:
  4. image: php:7.0.7-fpm-alpine
  5. volumes:
  6. - "./src:/var/www/html"
  7. restart: always
  8. tengine:
  9. depends_on:
  10. - php-fpm
  11. links:
  12. - php-fpm
  13. image: chasontang/tengine:2.1.2_f
  14. volumes:
  15. - "./nginx.vh.default.conf:/etc/nginx/conf.d/default.conf"
  16. ports:
  17. - "80:80"
  18. 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. listen 80;
  3. server_name localhost;
  4. #charset koi8-r;
  5. #access_log logs/host.access.log main;
  6. location / {
  7. root html;
  8. index index.html index.htm;
  9. }
  10. #error_page 404 /404.html;
  11. # redirect server error pages to the static page /50x.html
  12. #
  13. error_page 500 502 503 504 /50x.html;
  14. location = /50x.html {
  15. root html;
  16. }
  17. # proxy the PHP scripts to Apache listening on 127.0.0.1:80
  18. #
  19. #location ~ \.php$ {
  20. # proxy_pass http://127.0.0.1;
  21. #}
  22. location ~ [^/]\.php(/|$) {
  23. fastcgi_split_path_info ^(.+?\.php)(/.*)$;
  24. fastcgi_pass php-fpm:9000;
  25. fastcgi_index index.php;
  26. fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
  27. fastcgi_param PATH_INFO $fastcgi_path_info;
  28. include fastcgi_params;
  29. }
  30. # deny access to .htaccess files, if Apache's document root
  31. # concurs with nginx's one
  32. #
  33. #location ~ /\.ht {
  34. # deny all;
  35. #}
  36. }

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

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

赞 (0)
上一篇10-7
下一篇 10-10

相关推荐

  • php Smarty 模板使用方法详解

    phpSmarty模板使用方法详解一、模板中的注释每一个Smarty模板文件，都是通过Web前台语言(xhtml,css和javascript等)结合Smarty引擎的语法开发的。用到的web前台开发的语言和原来的完全一样，注释也没有变化S…
    •Php 与 Smarty
    2014-10-1019652

  • SQL Server 2005导入至2000的方法及注意事项

    SQLServer2005导入至2000的方法及注意事项由于自己开发环境使用的是MSSQLServer2005，而服务器上部署的依然是MSSQLServer2000，于是在系统开发完成后，还得将MSSQLServer2005导入MSSQLS…
    •Mysql
    2015-09-2710451

  • PHP的几个集成开发环境（IDE）介绍

    PHP的几个集成开发环境（IDE）介绍因为PHP是一种开放性的语言，这也导致了开发环境没有强而权威的支持。这里列举一些比较好的编辑工具，希望能给大家开发PHP程序提供一些帮助。Dreamweaver从MX开始，DW开始支持PHP+MySQL…
    •php环境搭建
    2015-11-115760

  • 如何解决Sybase数据库乱码问题详解

    如何解决Sybase数据库乱码问题详解搭建测试数据库服务器时，遇到了乱码问题，之前没有遇到是因为开发数据库服务器是早就安装好并设置好字符集的，因此些问题在部署测试环境时才出现，当时已经将数据库配置完毕，并且所有的初始化脚本都已经执行完毕，工…
    •Mysql
    2015-11-2917391

  • 深入PHP运行环境配置的详解

    深入PHP运行环境配置的详解运行环境配置:php54+Apache2.2+Mysql1.默认端口设置：#Listen12.34.56.78:80Listen80802.加载模型：LoadModulephp5_module"D:MyZILIA…
    •php环境搭建
    2016-05-227083

  • 如何正确配置PHP开发环境

    如何正确配置PHP开发环境PHP语言在进行开发之前，需要将开发环境配置妥当，这样才能实现我们的程序完美运行。那么，如何正确的配置PHP开发环境呢？文章将介绍Apache、MySql、PHP的下载、安装及配置，分别讲述在windows和Lin…
    •php环境搭建
    2016-08-3016895

  • eclipse下搭建php开发环境

    eclipse下搭建php开发环境今日打算学习PHP，工具还是使用我熟悉的eclipse。为了php环境的配置和调试配置，我花了很大功夫研究哈，以下是整理出来的方法：1.安装和配置PDT下载PDT:download.eclipse.org/…
    •php环境搭建
    2016-08-3118294

  • 搭建基于Docker的PHP开发环境的详细教程

    这篇文章主要介绍了搭建基于Docker的PHP开发环境的详细教程,Docker是当下虚拟机技术的最佳选择,需要的朋友可以参考下。现在很多开发者都使用Vagrant来管理他们的虚拟机开发环境，Vagrant确实很酷，不过也有不少缺点（最主要的是它占用太多的资源）。在容器技术、Docker和更多类Docker技术出现后，解决这个问题就变得简单了。免责声明由于boot2docker的工作方式，本文所述的…
    •php环境搭建
    2023-06-01645