someblackmagic/docker-php-extension-images

Docker PHP扩展镜像

概述

docker-php-extension-images提供了一系列预构建的PHP扩展Docker镜像，旨在简化PHP应用在Docker环境中的部署流程。这些镜像包含了各种常用PHP扩展，支持多种PHP版本，让开发者无需手动编译和配置PHP扩展，即可快速构建包含所需扩展的PHP运行环境。

核心功能和特性

主要特性

• 多PHP版本支持：兼容多个PHP主要版本，包括PHP 7.2+及以上版本
• 丰富扩展库：包含常用PHP扩展，如mysqli、pdo_mysql、gd、mbstring、redis、memcached等
• 即插即用：预编译扩展，无需手动编译安装
• 轻量级设计：基于官方PHP镜像构建，保持较小镜像体积
• 持续更新：定期更新以支持新的PHP版本和扩展版本
• 多架构支持：支持amd64、arm64等多种架构

使用场景

• 快速搭建PHP开发环境
• 简化CI/CD流程中的PHP环境配置
• 构建包含特定扩展的PHP应用镜像
• 解决PHP扩展编译困难的问题
• 确保开发、测试和生产环境的一致性

使用方法

基础用法

可以直接使用预构建的扩展镜像作为基础镜像，或在Dockerfile中引用：

dockerfile
# 直接使用包含特定扩展的完整镜像
FROM someblackmagic/php-extension:8.1-mysqli-redis

# 或者在现有PHP镜像中添加扩展
FROM php:8.1-fpm
COPY --from=someblackmagic/php-extension:8.1-redis /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
COPY --from=someblackmagic/php-extension:8.1-redis /usr/local/etc/php/conf.d/ /usr/local/etc/php/conf.d/

支持的PHP版本

• PHP 7.2
• PHP 7.3
• PHP 7.4
• PHP 8.0
• PHP 8.1
• PHP 8.2

常用扩展

• 数据库扩展：mysqli, pdo_mysql, pgsql, pdo_pgsql, mongodb
• 缓存扩展：redis, memcached, apcu
• 图像处理：gd, imagick
• 其他常用扩展：mbstring, curl, json, xml, zip, bz2

镜像标签格式

镜像标签遵循以下命名约定：

{php-version}-{extension1}-{extension2}-...-{extensionN}

例如：

• 8.1-redis - PHP 8.1 带 Redis 扩展
• 7.4-mysqli-pdo_mysql-gd - PHP 7.4 带 mysqli, pdo_mysql 和 gd 扩展

Docker Compose 示例

yaml
version: '3.8'

services:
  php:
    image: someblackmagic/php-extension:8.1-mysqli-redis-gd
    volumes:
      - ./php.ini:/usr/local/etc/php/php.ini
      - ./src:/var/www/html
    ports:
      - "9000:9000"
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d

自定义配置

如需自定义PHP配置，可以挂载自定义的php.ini文件：

bash
docker run -d \
  -v ./php.ini:/usr/local/etc/php/php.ini \
  someblackmagic/php-extension:8.1-redis

构建自己的扩展组合

如果需要特定的扩展组合，可以使用项目提供的构建脚本自行构建：

bash
git clone https://github.com/SomeBlackMagic/docker-php-extension-images.git
cd docker-php-extension-images
PHP_VERSION=8.1 EXTENSIONS="redis mysqli gd" ./build.sh

支持的平台

• linux/amd64
• linux/arm64
• linux/arm/v7

维护和更新

镜像会定期更新以包含最新的安全补丁和扩展版本。建议定期更新您的镜像以获取最新修复。

问题反馈

如遇到任何问题或有扩展需求，请在GitHub仓库提交issue：https://github.com/SomeBlackMagic/docker-php-extension-images/issues