如何在 docker 中使用 PHP FPM

已经有段时间没写过东西了,最近在着手把之前的 PHP 服务 docker 化,以方便在两台服务器之间部署。整个学习和使用 docker 的过程还算顺利吧,但在部署 PHP FPM 的过程中遇到了一些问题,以下作为记录供遇到同样问题的人参考吧。

系统架构

因为我可能会经常修改 Nginx 配置,加上我是自己编译的最新版的 Nginx + Openssl (为了启用 HTTP/2),所以就懒得把 Nginx 打包成 docker 镜像了,而是直接将 Nginx 装在了宿主机,并开放 80 和 443 端口。

系统所需的除 Nginx 以外的其它服务全部由 docker 提供服务,如 PHP 和 Redis。每一个服务使用一个容器,均为官方镜像。Redis 的使用就不说了,比较简单,说下在使用 PHP 时遇到的一些问题吧,主要是 Nginx 与 PHP 通信的问题。

附上 docker hub 官方的 PHP 首页地址:https://hub.docker.com/_/php/

失败的就不多说了,说下成功的两种方式:

方法一:Nginx 反向代理 + php-apache

这种方式使用 docker hub 官方提供的 php-apache 镜像。

1
$ docker pull

因为镜像内已经安装好了 PHP 和 Apache,所以只需在容器上开放端口,使用 Nginx 反向代理就可以了,比较简单。

例如下面的将容器内的 80 端口映射到宿主机的 9090 端口:

1
$ docker run -d -p 9090:80 -v /home/www/:/var/www/html php:7.0-apache

Nginx 配置下反向代理即可:

1
2
3
location / {
proxy_pass 127.0.0.1:9090;
}

方法二:Nginx + php-fpm

这种方式只使用 PHP 的容器提供 FPM 服务供宿主机的 Nginx 调用,会比多一个 Apache 来得更轻量一些。只是这种方式一直比较困扰我的是如何在 Nginx 里面调用容器内的 FPM 服务,毕竟容器内外的环境是不一样的,和直接宿主机安装 LNMP 还是有不少差距的。更纠结的是,docker hub 官方文档中并没有说 php-fpm 怎么用。

经过多次尝试最终发现 Nginx 调用 fpm 服务是通过 fastcgi 参数进行的。如通过 SCRIPT_FILENAME 参数指定要加载的文件路径。

一般 LNMP 环境 Nginx 的配置可能是这样的(部分):

1
2
3
4
5
6
7
location ~ [^/]\.php(/|$) {
try_files $uri =404;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}

fastcgi_pass 倒是很好理解,指定 fpm 服务的调用地址,只需要把容器中的 9000 端口映射到宿主机的 9000 端口上就可以了。

fastcgi_index 也好理解,就是默认文件嘛。

重点在 fastcgi_param,每一个 fastcgi_param 指令都定义了一个会发送给 cgi 进程的参数,打开 Nginx 配置目录中的 fastcgi_params 文件可以看到里面定义了很多参数。其中,SCRIPT_FILENAME 对我们来说算是最重要的。

SCRIPT_FILENAME 指令指定了 cgi 进程需要加载的文件路径。例如用户访问 http://xxx.com/a.php,Nginx 中将会处理此次请求。Nginx 判断后缀名是 .php 的请求后将会把此次请求转发给 cgi 进程处理,即 fastcgi_pass;转发的过程中会携带一些和访问相关的参数或其它预设的参数(fastcgi_param),然而这个 cgi 进程(PHP FPM)并不知道要加载的文件在哪里,这便是 SCRIPT_FILENAME 的作用了。

简单的说,配置 SCRIPT_FILENAME 的值就是要做到 FPM 进程能找到这个文件就可以了。例如代码目录存放在宿主机的 /home/www 目录下,我们使用 -v 命令启动 docker 时把代码目录映射到了容器内部的 /var/www/html 目录下:

1
$ docker run -d -p 9000:9000 -v /home/www:/var/www/html php:7.0-fpm

因为 fpm 进程是运行在容器里面的,所以 SCRIPT_FILENAME 查找的路径一定是在容器内能找到的,即:

1
fastcgi_param SCRIPT_FILENAME /var/www/html/$fastcgi_script_name;

至此应该全明白了吧,Nginx 配置中的 SCRIPT_FILENAME 要和容器中保持一致才行。当然也可以让容器中的目录结构保持与宿主机中一致,即 -v /home/www:/home/www,这样配置的时候可能会方便一些,不会出现因目录不一致而出错的机率。

总结

学习就是踩坑的过程,踩着踩着就学会了。。。