前言

此篇，主要是演示docker-php-source , docker-php-ext-install ,docker-php-enable-docker-configure 这四个命令到底是用来干嘛的，它们在PHP容器中都做了哪些事情。
很多人很不理解在Dockerfile中安装PHP扩展的时候总是出现这几个命令，本篇就就是为你揭开这些命令的神秘面纱而准备的，所有案例都是本人自己运行过的。

Docker 中的PHP容器安装扩展的方式有
  1. 通过pecl方式安装
  2. 通过php 容器中自带的几个特殊命令来安装，这些特殊命令可以在Dockerfile中的RUN命令中进行使用。

这里，我们主要讨论的是第二种方案，如何通过PHP容器中的几个特殊命令来安装PHP扩展

PHP中安装扩展有几个特殊的命令

  • docker-php-source
  • docker-php-ext-install
  • docker-php-ext-enable

  • docker-php-ext-configure

    演示这三个命令的作用

    都是在PHP容器中进行演示的，PHP容器启动太简单，不作过多介绍

    docker-php-source

    此命令，实际上就是在PHP容器中创建一个/usr/src/php的目录，里面放了一些自带的文件而已。我们就把它当作一个从互联网中下载下来的PHP扩展源码的存放目录即可。事实上，所有PHP扩展源码扩展存放的路径： /usr/src/php/ext 里面。
    格式：

    1. docker-php-source extract | delete

    参数说明：
    extract : 创建并初始化 /usr/src/php目录
     delete : 删除 /usr/src/php目录
    案例：

    1. root@803cbcf702a4:/usr/src# ls -l
    2. total 11896 #此时，并没有php目录
    3. -rw-r--r-- 1 root root 12176404 Jun 28 03:23 php.tar.xz
    4. -rw-r--r-- 1 root root      801 Jun 28 03:23 php.tar.xz.asc
    5. root@803cbcf702a4:/usr/src# docker-php-source extract
    6. root@803cbcf702a4:/usr/src# ls -l
    7. total 11900 #此时，生产了php目录，里面还有一些文件，由于篇幅问题，就不进去查看了
    8. drwxr-xr-x 14 root root     4096 Aug  9 09:01 php
    9. -rw-r--r--  1 root root 12176404 Jun 28 03:23 php.tar.xz
    10. -rw-r--r--  1 root root      801 Jun 28 03:23 php.tar.xz.asc
    11. root@803cbcf702a4:/usr/src# docker-php-source delete
    12. root@803cbcf702a4:/usr/src# ls -l
    13. total 11896 #此时，将已创建 php 目录给删除了
    14. -rw-r--r-- 1 root root 12176404 Jun 28 03:23 php.tar.xz
    15. -rw-r--r-- 1 root root      801 Jun 28 03:23 php.tar.xz.asc
    16. root@803cbcf702a4:/usr/src#

    docker-php-ext-enable

    这个命令，就是用来启动 PHP扩展 的。我们使用pecl安装PHP扩展的时候，默认是没有启动这个扩展的，如果想要使用这个扩展必须要在php.ini这个配置文件中去配置一下才能使用这个PHP扩展。而 docker-php-ext-enable 这个命令则是自动给我们来启动PHP扩展的，不需要你去php.ini这个配置文件中去配置。
    案例

    1. # 查看现有可以启动的扩展
    2. root@517b9c67507a:/usr/local/etc/php# ls /usr/local/lib/php/extensions/no-debug-non-zts-20170718/
    3. opcache.so  redis.so  sodium.so
    4. root@517b9c67507a:/usr/local/etc/php#
    5. # 查看redis 扩展是否可以启动
    6. root@517b9c67507a:/usr/local/etc/php# php -m | grep redis
    7. root@517b9c67507a:/usr/local/etc/php#
    8. # 启动 redis 扩展
    9. root@517b9c67507a:/usr/local/etc/php# docker-php-ext-enable redis
    10. # 启动 成功
    11. root@517b9c67507a:/usr/local/etc/php# php -m | grep redis
    12. redis
    13. root@517b9c67507a:/usr/local/etc/php#
    14. #说明，php容器中默认是没有php.ini配置文件的,加载原理如下所示
    15. root@517b9c67507a:/usr/local/etc/php# php -i | grep -A 5 php.ini
    16. Configuration File (php.ini) Path => /usr/local/etc/php
    17. Loaded Configuration File => (none)
    18. # 核心是 /usr/local/etc/php/conf.d 目录下的扩展配置文件
    19. Scan this dir for additional .ini files => /usr/local/etc/php/conf.d
    20. Additional .ini files parsed => /usr/local/etc/php/conf.d/docker-php-ext-redis.ini,
    21. /usr/local/etc/php/conf.d/docker-php-ext-sodium.ini
    22. root@517b9c67507a:/usr/local/etc/php#

    docker-php-ext-install

    这个命令，是用来安装并启动PHP扩展的。
    命令格式：
    docker-php-ext-install “源码包目录名”
    注意点：

  • “源码包“需要放在 /usr/src/php/ext 下

  • 默认情况下，PHP容器没有 /usr/src/php这个目录，需要使用 docker-php-source extract来生成。
  • docker-php-ext-install 安装的扩展在安装完成后，会自动调用docker-php-ext-enable来启动安装的扩展。
  • 卸载扩展，直接删除/usr/local/etc/php/conf.d 对应的配置文件即可。

案例

  1. # 卸载redis 扩展
  2. root@803cbcf702a4:/usr/local# rm -rf /usr/local/etc/php/conf.d/docker-php-ext-redis.ini
  3. root@803cbcf702a4:/usr/local# php -m 
  4. [PHP Modules]
  5. Core
  6. ctype
  7. curl
  8. date
  9. dom
  10. fileinfo
  11. filter
  12. ftp
  13. hash
  14. iconv
  15. json
  16. libxml
  17. mbstring
  18. mysqlnd
  19. openssl
  20. pcre
  21. PDO
  22. pdo_sqlite
  23. Phar
  24. posix
  25. readline
  26. Reflection
  27. session
  28. SimpleXML
  29. sodium
  30. SPL
  31. sqlite3
  32. standard
  33. tokenizer
  34. xml
  35. xmlreader
  36. xmlwriter
  37. zlib
  38. [Zend Modules]
  39. root@803cbcf702a4:/usr/local#
  40. #PHP容器默认是没有redis扩展的。所以我们通过docker-php-ext-install安装redis扩展
  41. root@803cbcf702a4:/# curl -L -o /tmp/reids.tar.gz https://codeload.github.com/phpredis/phpredis/tar.gz/5.0.2
  42. root@803cbcf702a4:/# cd /tmp
  43. root@517b9c67507a:/tmp# tar -xzf reids.tar.gz
  44. root@517b9c67507a:/tmp# ls
  45. phpredis-5.0.2    reids.tar.gz
  46. root@517b9c67507a:/tmp# docker-php-source extract
  47. root@517b9c67507a:/tmp# mv phpredis-5.0.2 /usr/src/php/ext/phpredis
  48. #检查移过去的插件源码包是否存在
  49. root@517b9c67507a:/tmp# ls -l /usr/src/php/ext | grep redis
  50. drwxrwxr-x  6 root root 4096 Jul 29 15:04 phpredis
  51. root@517b9c67507a:/tmp# docker-php-ext-install phpredis
  52. # 检查redis 扩展是否已经安装上
  53. root@517b9c67507a:/tmp# php -m | grep redis
  54. redis
  55. root@517b9c67507a:/tmp#

docker-php-ext-configure

docker-php-ext-configure 一般都是需要跟 docker-php-ext-install搭配使用的。它的作用就是，当你安装扩展的时候，需要自定义配置时，就可以使用它来帮你做到。
案例

  1. FROM php:7.1-fpm
  2. RUN apt-get update \
  3.     # 相关依赖必须手动安装
  4.     && apt-get install -y \
  5.         libfreetype6-dev \
  6.         libjpeg62-turbo-dev \
  7.         libmcrypt-dev \
  8.         libpng-dev \
  9.     # 安装扩展
  10.     && docker-php-ext-install -j$(nproc) iconv mcrypt \
  11.     # 如果安装的扩展需要自定义配置时
  12.     && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \
  13.     && docker-php-ext-install -j$(nproc) gd