php.md

# PHP 扩展列表

> 更多扩展请通过 `$ php -m` 查看

如果你需要增加其他扩展，请到这里 [issues](https://github.com/khs1994-docker/lnmp/issues/63) 反馈。

## pecl 扩展

* [igbinary](http://pecl.php.net/package/igbinary)
* [memcached ( memcache 太旧)](https://pecl.php.net/package/memcached)
* [mongodb ( mongo 已经废弃)](https://pecl.php.net/package/mongodb)
* [redis](https://pecl.php.net/package/redis)
* [Swoole](http://pecl.php.net/package/swoole)
* [xdebug (生产环境不启用)](https://pecl.php.net/package/xdebug)

**核心扩展**

* **mysql** 7.0 移除
* **mcrypt** 7.2 移除
* **interbase** 7.4 移除
* **wddx** 7.4 移除
* **recode** 7.4 移除
* **xmlrpc** 8.0 移除

## 自行增加扩展

以下两种方式任选一种，然后按照 [自定义](custom.md) 替换为自己的镜像，具体实例可以 [参考这里](https://github.com/khs1994-docker/php/tree/master/custom)：

**1. 基于 `khs1994/php:X.Y.Z-TYPE-alpine` 重新构建镜像**

```docker
ARG PHP_VERSION=7.3.17
ARG USERNAME=khs1994

FROM ${USERNAME}/php:${PHP_VERSION}-fpm-alpine

# 扩展源码在 PHP 源码
ENV PHP_CORE_EXT \
    xsl

# pecl 扩展
# 如果 PHP 版本已经 EOL，建议加上版本号，因为新的扩展可能不再兼容旧的 PHP 版本
ENV PHP_PECL_EXT \
    xxx \
    xxx2-beta \
    xxx3-x.y.z

ENV EXT_BUILD_DEP \
    xxx-dev

ENV EXT_RUN_DEP \
    xxx

ARG ALPINE_URL=dl-cdn.alpinelinux.org

RUN set -x \
    && sed -i "s/dl-cdn.alpinelinux.org/${ALPINE_URL}/g" /etc/apk/repositories \
    # 安装构建依赖，构建之后可以删除
    && apk add --no-cache --virtual .pecl_build_deps $EXT_BUILD_DEP $PHPIZE_DEPS \
    # 安装运行依赖，不可以删除
    && apk add --no-cache $EXT_RUN_DEP \
    # ！请自行编辑以下内容
    # 解压 PHP 源码，仅当扩展源码在 PHP 源码中时需要
    # && docker-php-source extract \
    #
    # 5.6 | 7.0
    #
    # && docker-php-ext-configure XXX --XXX \
    && docker-php-ext-install $PHP_CORE_EXT \
    && docker-php-ext-enable $PHP_CORE_EXT \
    && for extension in ${PHP_PECL_EXT};do \
         ext_real_name=$(echo ${extension} | cut -d '-' -f 1) \
         && pecl install $extension \
         && docker-php-ext-enable $ext_real_name || echo "pecl ${extension} install error" \
         && rm -rf /usr/local/lib/php/doc/$ext_real_name \
         && rm -rf /usr/local/lib/php/test/$ext_real_name \
         && rm -rf /usr/local/include/php/ext/$ext_real_name \
         && strip --strip-all $(php-config --extension-dir)/$ext_real_name.so ; \
       done \
    #
    # 7.1 + 可以使用 pickle 安装 PHP 扩展
    #
    # && echo "--xxx" > /tmp/EXT_NAME.configure.options \
    && pickle install $PHP_CORE_EXT $PHP_PECL_EXT -n --defaults --strip --cleanup \
    # ！请自行编辑以上内容
    # 清理
    && docker-php-source delete \
    && apk del --no-network .pecl_build_deps \
    && rm -rf /tmp/* \
    && rm -rf /usr/local/lib/php/.registry/.channel.pecl.php.net/* \
    # 验证
    && php -m \
    && ls -la $(php-config --extension-dir)
    # ！请自行编辑以下内容
    # 默认不启用的扩展可以将配置文件改为不以 .ini 结尾的文件名
    # && mv /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
    #     /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini.default
```

**2. 使用 Dockerfile 重头构建**

* https://github.com/khs1994-docker/php

```bash
# 这里只列出基本参数，其他参数按需自行添加
$ docker buildx build \
  --build-arg PHP_EXTENSION_EXTRA="xsl" \
  --build-arg PECL_EXTENSION_EXTRA="imagick msgpack" \
  --build-arg APK_EXTRA="libxslt imagemagick-libs musl" \
  --build-arg APK_DEV_EXTRA="libxslt-dev imagemagick imagemagick-dev" \
  --build-arg PHP_VERSION="X.Y.Z" \
  --build-arg USERNAME=${USERNAME:?USERNAME must set} \
  --build-arg ALPINE_URL=${ALPINE_URL:-dl-cdn.alpinelinux.org} \
  --push \
  -t USERNAME/php:X.Y.Z-TYPE-alpine FOLDER
```

## 官方扩展列表

```bash
$ 进入 PHP 源码目录 ext 目录

$ docker run -it -d khs1994/php-fpm:7.2.4-alpine3.7

# 记住 container id ,并替换下边命令的 CONTAINER_ID

$ for ext in `ls`; do echo '*' $( docker exec -it CONTAINER_ID php -r "if(extension_loaded('$ext')){echo '[x] $ext';}else{echo '[ ] $ext';}" ); done

$ docker rm -f CONTAINER_ID
```

* [x] bcmath
* [x] bz2
* [x] calendar
* [ ] com_dotnet
* [x] ctype
* [x] curl
* [x] date
* [ ] dba
* [x] dom
* [x] enchant
* [x] exif
* [ ] ext_skel.php
* [x] ffi
* [x] fileinfo
* [x] filter
* [x] ftp
* [x] gd
* [x] gettext
* [x] gmp
* [x] hash
* [x] iconv
* [x] imap
* [x] intl
* [x] json
* [x] ldap
* [x] libxml
* [x] mbstring
* [x] mysqli
* [x] mysqlnd
* [ ] oci8
* [ ] odbc
* [ ] opcache
* [x] openssl
* [x] pcntl
* [x] pcre
* [x] pdo
* [ ] pdo_dblib
* [ ] pdo_firebird
* [x] pdo_mysql
* [ ] pdo_oci
* [ ] pdo_odbc
* [x] pdo_pgsql
* [x] pdo_sqlite
* [x] pgsql
* [x] phar
* [x] posix
* [x] pspell
* [x] readline
* [x] reflection
* [x] session
* [x] shmop
* [x] simplexml
* [ ] skeleton
* [ ] snmp
* [x] soap
* [x] sockets
* [x] sodium
* [x] spl
* [x] sqlite3
* [x] standard
* [x] sysvmsg
* [x] sysvsem
* [x] sysvshm
* [x] tidy
* [x] tokenizer
* [x] xml
* [x] xmlreader
* [ ] xmlrpc
* [x] xmlwriter
* [x] xsl
* [ ] zend_test
* [x] zip
* [x] zlib

## Session Redis 驱动

```ini
session.save_handler = redis

session.save_path ="tcp://redis:6379?auth=redis密码"
```

## More Information

* [mongodb](https://github.com/mongodb/mongo-php-driver)