docker 安装 php-fpm 服务 / 扩展 / 配置的示例教程详解
在 mac
上用 brew
装 php56
时,因为 openssl
是 1.1
版本而导致各种 google
都搞不定的错误,太折腾了,现在用 docker
创建一个 php56-fpm
服务容器,nginx
直装在宿主机上。
创建容器
# 创建容器 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
常见问题
1、File not found
nginx 指定的 站点根目录 无法直接映射给 fpm 容器,在 location 中重新指定 fpm 容器的 站点根目录。
2、apt-get E: Unable to locate package
执行 apt-get update 刷新一下源即可。
3、容器的相关约定
工作目录:/var/www/html 建议将宿主机的站点目录映射至此目录
配置目录:/usr/local/etc 注意配置目录结构
php 扩展目录:/usr/local/php/ext 可以查看 php 自带的扩展包 使用 docker-php-ext-install 安装更方便