docker 安装 php-fpm 服务 / 扩展 / 配置

在 mac 上用 brew 装 php56 时，由于 openssl 是 1.1 版本而致使各类 google 都搞不定的错误，太折腾了，如今用 docker 建立一个 php56-fpm 服务容器，nginx 直装在宿主机上。

PHP DockerHub 主页

---

建立容器

# 建立容器
docker run -d \
--name php56-fpm \
-p 9056:9000 \
-v /home/wwwroot:/var/www/html
--privileged=true
php:5.6-fpm

---

注意：
/var/www/html 是 php docker 镜像的工做目录。

-v /home/wwwroot:/var/www/html 的做用是将宿主机的站点目录挂载到容器上。好比 /home/wwwroot/siteA，在容器中的访问位置是 /var/www/html/siteA。

nignx 转发 php 请求时，会将执行的脚本名 SCRIPT_NAME 和脚本文件名 SCRIPT_FILENAME 转发给 fpm，然后 fpm 去读取脚本执行。

在使用 fpm 容器时，须要注意 nginx 转发的 SCRIPT_FILENAME 是不是 fpm 容器中的有效站点路径，若是 nginx 的 root 并不能直接映射至 fpm 容器的站点 root，咱们须要在 php location 中从新定义为 fpm 容器的站点 root。这样 fpm 才能正确的读取到脚本。

即宿主机上的 /home/wwwroot/siteA/public/index.php 要转为 /var/www/html/siteA/public/index.php 发送给 fpm 容器，不然会报 File not found 的错误。

因此 nginx 配置 server 时要注意以下的卷路径转换：

server {
    listen 8056;
    ....
    # 宿主机的站点根目录
    root /home/wwwroot/siteA/public;
    
    location ~* (^[/]*.php)[/|$] {
        # 容器中的站点根目录
        root /var/www/html/siteA/public;
        pass_proxy: 127.0.0.1:9056;
        include fastcgi.conf;
    }
}

不过通常状况下你们都是 docker nginx + docker php-fpm，两个容器都统一映射了站点目录，就不会有这个问题了。这里的 nginx 是直接装在宿主机上才致使 nginx 转发 php 请求时须要从新定义下站点的根目录。

---

登录容器

# 查看容器是否运行
docker ps

# 登录容器
docker exec -it php56-fpm /bin/bash

php 的 docker 镜像是基于 ubuntu 咱们可使用 apt-get 安装须要的工具，好比 vim/vi lrzsz net-tools 之类的。

# 在使用 apt-get 安装一些工具前，须要 update  更新一下源
# 不然会 apt-get E: Unable to locate package
apt-get update
apt-get install vim

---

安装 php/pecl 扩展

安装 php 扩展

即 php 官方扩展，好比 shomp 这种自带但默认不开启的扩展。

# 查看自带了那些扩展
cd /usr/local/php/ext && ls -l
# 安装扩展
dcoker-php-ext-install shmop

安装 pecl 扩展

容器中是有安装 pecl的，因此直接使用 pecl 安装便可，注意扩展对 php 版本的支持便可。

docker-php-ext-enable的主要用途是生成扩展相应的配置文件到 /usr/local/etc/php/conf.d/docker-php-ext-{extName}.ini 方便 php 加载扩展。

# igbinary php5.6 最高版本是 2.0.8
pecl install igbinary-2.0.8
docker-php-ext-enable igbinary

# phpredis php5.6 最高版本是 4.3.0
pecl install redis-4.3.0
docker-php-ext-enable redis

# swoole php5.6 最高版本是 2.0.11
pcel install swoole-2.0.11
docker-php-ext-enable swoole

---

php/php-fpm 配置

/usr/local/etc 是 php 容器的配置目录，里面自带了 php 及 php-fpm 的配置文件，配置目录结构以下：

root@aa739592b579:/usr/local# tree etc/  
etc/
|-- pear.conf
|-- php # php 配置目录
|   |-- conf.d # php 扩展配置
|   |   |-- docker-php-ext-shmop.ini
|   |-- php.ini # cp 的 php.ini-development/production
|   |-- php.ini-development
|   |-- php.ini-production
|-- php-fpm.conf # php-fpm 的配置 自带的主要是引入 php-fpm.d
|-- php-fpm.conf.default # php-fpm 配置本体 同 php-fpm.d/www.conf 一致
|-- php-fpm.d # php-fpm 的扩展配置
    |-- docker.conf
    |-- www.conf # php-fpm 配置本体 模式啊 max/min children 啊都在这里
    |-- zz-docker.conf

你可映射宿主机的配置目录到容器的 /usr/local/etc，但要注意宿主机上的配置目录与容器现有的要保持一致，或者直接在容器里编辑配置文件。按 docker 的理念咱们应该在宿主机上维护一份配置文件映射到容器的配置目录上，这样才能发挥出 docker 容器的复用性。

映射宿主机的 php 配置文件到容器

-v /opt/docker/conf/php/php.ini:/usr/local/etc/php/php.ini
-v /opt/docker/conf/php/php-fpm.ini:/usr/local/etc/php-fpm.d/www/conf

---

常见问题

一、File not found
nginx 指定的 站点根目录 没法直接映射给 fpm 容器，在 location 中从新指定 fpm 容器的 站点根目录。

二、apt-get E: Unable to locate package
执行 apt-get update 刷新一下源便可。

三、容器的相关约定 工做目录：/var/www/html 建议将宿主机的站点目录映射至此目录 配置目录：/usr/local/etc 注意配置目录结构 php 扩展目录：/usr/local/php/ext 能够查看 php 自带的扩展包 使用 docker-php-ext-install 安装更方便