使用Docker运行基于Nginx+PHP的应用程序

发表于   |   分类于

TL;DR

Docker作为目前主流的容器技术之一，可以更高效的利用系统资源，拥有更快的启动时间，提供一致的运行环境，能更轻松的维护和扩展。

作为开发者，在这项技术出现多年之后，是时候将他用于加速自己的App的开发、测试、部署阶段了。

本文是个人的学习笔记，目的在于描述如何让一个基于 Nginx + PHP 的应用程序在 Docker 中运行起来。原理性的内容会另起篇幅。

运行环境

OS

使用 Ubuntu 16.04 LTS 完成，同样也可以选用 CentOS 7，因为问题较多，放弃了在 CentOS 6.5 上的尝试（毕竟是很老的系统了）。

Docker

1.13

Nginx

选用了比较喜欢的 Openresty，版本为 1.13.6.1，镜像为 openresty/openresty:alpine。

PHP

本文为 7.2.2，镜像为 php:7.2.2-fpm-alpine3.7。

部署

如果要用 Docker 运行自己的应用程序，首先要对镜像有一定的了解。

openresty 容器

对于 OpenResty 来说，Dockerfile 需要了解的主要是 Nginx 的配置。

从 Dockerfile 中可以看到 nginx.conf 是在构建时拷贝到容器之中的。

1
COPY nginx.conf /usr/local/openresty/nginx/conf/nginx.conf

在 GitHub 上可以看到 nginx.conf 文件的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream;

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

    include /etc/nginx/conf.d/*.conf;
}

可以了解到如下信息：

  • Nginx 配置文件为 /usr/local/openresty/nginx/conf/nginx.conf
  • vhosts配置文件目录为 /etc/nginx/conf.d/，这一个目录可以放置需要运行的项目的Nginx配置文件

php-fpm 容器

对于 PHP 来说，Dockerfile 需要了解的至少有如下几个方面：

  • php/php-fpm/php-config 等二进制文件的安装位置
  • php.ini 文件的位置以及内容
  • php-fpm.conf 文件的位置以及内容
  • php-fpm 运行用户与用户组

Docker 在构建镜像时，通过 Dockerfile 对构建镜像的动作进行描述。可以通过分析一下这个文件了解一下选用镜像的特点。

php:7.2.2-fpm-alpine3.7 Dockerfile

源文件 内容虽然多，但是需要关注的东西并不多，带着之前的问题去阅读这个文件。

这个文件事实上完成的主要是如下几个工作：

  • 声明依赖的基础镜像
  • 设定环境变量
  • 拷贝 PHP 环境所需的特定工具（如扩展安装工具）
  • 构建以及配置 PHP 7.2.2
  • 启动 php-fpm 以及暴露端口

php/php-fpm/php-config 等二进制文件的安装位置

在整个文件中没有看到诸如 --prefix 这样的参数，那么可以得知会把这些文件默认安装到 /usr/local/bin/ 目录下。

启动一个容器进行验证：

1
2
3
4
5
 ➜ docker run -it --rm php:7.2.2-fpm-alpine3.7 /bin/sh
/var/www/html # ls /usr/local/bin/
docker-php-entrypoint     docker-php-ext-install    peardev                   phar.phar                 phpdbg
docker-php-ext-configure  docker-php-source         pecl                      php                       phpize
docker-php-ext-enable     pear                      phar                      php-config

php.ini 文件的位置以及内容

文件37行:

1
ENV PHP_INI_DIR /usr/local/etc/php

在后续构建 configure 阶段（92行开始）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
RUN set -xe \
	&& apk add --no-cache --virtual .build-deps \
		$PHPIZE_DEPS \
		coreutils \
		curl-dev \
		libedit-dev \
		libressl-dev \
		libxml2-dev \
		sqlite-dev \
	\
	&& export CFLAGS="$PHP_CFLAGS" \
		CPPFLAGS="$PHP_CPPFLAGS" \
		LDFLAGS="$PHP_LDFLAGS" \
	&& docker-php-source extract \
	&& cd /usr/src/php \
	&& gnuArch="$(dpkg-architecture --query DEB_BUILD_GNU_TYPE)" \
	&& ./configure \
		--build="$gnuArch" \
		--with-config-file-path="$PHP_INI_DIR" \
		--with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \

可以看到也定义了这一个目录。

然而在整个文件中也没有看到拷贝 ini 文件到对应目录的操作，所以这个容器是没有使用 php.ini 文件进行配置的。

如果想要知道当前默认的配置项，不妨进入容器，通过 /usr/local/bin/php -i 进行查看。

php-fpm.conf 文件的位置以及内容

类似 php.ini 文件的情况。

php-fpm 运行用户与用户组

这里涉及到一个权限的问题，Docker 可以把应用代码拷贝到容器中，但是也可以通过挂载目录的方式完成，将目录的 owner 设定为当前容器运行的 uid 可以避免权限带来问题。

文件29行可以看到新增了 uid 为 82 的 www-data 用户。

1
2
3
RUN set -x \
	&& addgroup -g 82 -S www-data \
	&& adduser -u 82 -D -S -G www-data www-data

在构建阶段，也声明了 fpm 运行者为 www-data：

1
ENV PHP_EXTRA_CONFIGURE_ARGS --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data

启动容器

Docker 容器之间不能直接访问，可以用 link 的方式，也可以直接把端口映射到主机端口上，通过主机的网络进行通信。

需要先行启动 php-fpm 容器。

启动 php-fpm 容器

因为需要配置诸如时区等配置，然而当前容器又没有默认的 php.ini 文件，可以挂载一个自行配置 php.ini 文件。

php.ini 配置文件中将 PHP 错误日志目录定义为 /var/www/logs/php_error.log，所以挂载可以写入日志的目录到容器中的 /var/www/logs 目录下。

1
2
3
4
5
6
docker run --name=test_phpfpm \
-v /data1/www/etc/test/conf/php/php.ini:/usr/local/etc/php/php.ini:ro \
-v /data1/www/etc/test/conf/php:/usr/local/etc/php/conf.d/:ro \
-v /data1/www/htdocs/test:/var/www/html \
-v /data1/www/logs:/var/www/logs \
-d php:7.2.2-fpm-alpine3.7

php-fpm 的容器名为 test_phpfpm ，与之连接的其他容器可以通过这个名字直接访问容器。

启动 openresty 容器

1
2
3
4
5
6
docker run --link=test_phpfpm --name=test_openresty -p 8808:80 \
-v /data1/www/etc/test/conf/nginx/nginx.test.config:/usr/local/openresty/nginx/conf/nginx.conf:ro \
-v /data1/www/etc/test/conf/nginx:/etc/nginx/conf.d/:ro \
-v /data1/www/logs:/usr/local/openresty/nginx/logs \
-v /data1/www/htdocs/test:/var/www/html \
-d openresty/openresty:alpine

对应的 Nginx 配置文件为：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
worker_processes  1;

events {
    worker_connections  65535;
}


http {
    include       mime.types;
    #default_type  application/octet-stream;
    default_type  text/html;

    sendfile        on;

    keepalive_timeout  65;

    server {
        listen 80 default_server;
        root /var/www/html;
        index index.php index.html index.htm;

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

        location ~ \.php($|/) {
            fastcgi_pass          test_phpfpm:9000;
            fastcgi_index         index.php;
            include               fastcgi_params;
            set $path_info        "";
            set $real_script_name $fastcgi_script_name;

            if ($fastcgi_script_name ~ "^(.+?\.php)(/.+)$") {
                set $real_script_name $1;
                set $path_info        $2;
            }

            fastcgi_param SCRIPT_FILENAME $document_root$real_script_name;
            fastcgi_param SCRIPT_NAME     $real_script_name;
            fastcgi_param PATH_INFO       $path_info;
            fastcgi_param PHP_VALUE       open_basedir=$document_root:/tmp/:/proc/:/dev/urandom;
        }
    }

    include /etc/nginx/conf.d/*.conf;
}

至此，在宿主机 /data1/www/htdocs/test 目录下的 PHP 项目可以对外提供服务了。