dockerphpext/mongodb

Docker PHP扩展镜像

本项目提供预编译的PHP扩展Docker镜像，旨在让PHP扩展的安装过程更快速、更轻量。

GitHub仓库： https://github.com/docker-php-ext/Dockerfile

通过使用这些预编译镜像，您可以避免在最终生产镜像中引入长时间的构建过程和繁重的依赖（如build-base、autoconf、gcc等）。

🚀 工作原理

每个扩展都基于Alpine系统构建为独立的Docker镜像。构建过程中会提取以下内容：

1. 编译好的.so扩展文件
2. 扩展依赖的共享库（.so）
3. 预配置的启用扩展的.ini文件

这些产物存储在扩展镜像的/opt/php/目录下，您可以轻松地将它们COPY到自己的Docker镜像中。

📦 使用方法

要在您的Dockerfile中使用扩展，只需从对应的扩展镜像复制文件即可。

示例：为PHP 8.3安装mongodb扩展

dockerfile
FROM php:8.3-alpine

# 启用PHP扩展扫描目录，这是扩展生效的关键
ENV PHP_INI_SCAN_DIR=/opt/php/conf.d:/usr/local/etc/php/conf.d

# 从预编译镜像复制扩展及其依赖
COPY --from=dockerphpext/mongodb:php8.3-alpine /opt/php/ /opt/php/

注：Docker镜像托管在Docker Hub的https://hub.docker.com/u/dockerphpext%E7%94%A8%E6%88%B7%E5%90%8D%E4%B8%8B%E3%80%82

🛠 支持的扩展

目前支持PHP版本8.0、8.1、8.2、8.3、8.4和8.5的以下扩展：

• bcmath、calendar、exif、mongodb、gettext、gmp、grpc、igbinary、imagick、imap、intl、ldap、memcache、memcached、msgpack、mysqli、opcache、pcntl、pcov、pdo_mysql、pdo_pgsql、protobuf、redis、sockets、uuid、xdebug、xmlrpc、xsl、yaml、zip

（最新扩展列表请查看extensions/目录。）

🔨 本地开发

您可以使用提供的Makefile本地构建和测试扩展。

构建扩展

bash
make build extension=redis php_version=8.3

测试单个扩展版本

bash
make run-single-test extension=redis php_version=8.3

测试扩展的所有版本

bash
make run-test extension=redis

🏗 项目结构

• extensions/：包含每个扩展和PHP版本的Dockerfile
• scripts/：构建过程中使用的辅助脚本
• tests/：确保扩展编译和加载正常的测试套件
• .github/workflows/：自动化构建、测试和发布的GitHub Actions配置

📜 许可证

本项目基于MIT许可证开源 - 详情请查看LICENSE文件。