dockerphpext/pdo_pgsql

Docker PHP扩展镜像

本项目提供预编译的PHP扩展Docker镜像，旨在快速、轻量地安装PHP扩展。通过使用这些预编译镜像，您可以避免生产镜像中出现冗长的构建时间和 heavy 依赖（如build-base、autoconf、gcc等）。

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

🚀 工作原理

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

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

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

📦 使用场景

适用于需要快速集成PHP扩展的开发与生产环境，尤其适合希望减少镜像体积、缩短构建时间的PHP项目。

🛠 配置说明

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

部署示例：为PHP 8.3安装pdo_pgsql

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/pdo_pgsql:php8.3-alpine /opt/php/ /opt/php/

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

📋 支持的扩展

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

• bcmath、calendar、exif、pdo_pgsql、gettext、gmp、grpc、ig***ary、imagick、imap、intl、ldap、memcache、memcached、mongodb、msgpack、mysqli、opcache、pcntl、pcov、pdo_mysql、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文件。