columbusinteractive/php-dev

Docker PHP 开发镜像文档

镜像概述与主要用途

本镜像基于 https://hub.docker.com/r/_/php/ 构建，通过 https://github.com/mlocati/docker-php-extension-installer 集成了常用扩展，适用于 PHP 应用开发环境。镜像托管于 https://hub.docker.com/r/columbusinteractive/php-dev/%EF%BC%8C%E6%94%AF%E6%8C%81%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E4%BB%A5%E7%A1%AE%E4%BF%9D%E4%B8%8E%E5%AE%98%E6%96%B9 PHP 镜像同步更新。

核心功能与特性

• 基于官方镜像：继承官方 PHP 镜像的稳定性与兼容性，作为基础环境
• 扩展增强：在基础镜像之上额外安装 xdebug 扩展，满足开发调试需求
• 多版本与变体支持：提供多种 PHP 版本（8.0/8.1/8.2）及运行时变体（标准/Alpine/FPM/FPM-Alpine）
• 预装 Composer：全局集成 Composer v2，简化依赖管理流程

可用标签

支持以下 PHP 版本及变体标签：

• 8.2、8.2-alpine、8.2-fpm、8.2-fpm-alpine
• 8.1、8.1-alpine、8.1-fpm、8.1-fpm-alpine
• 8.0、8.0-alpine、8.0-fpm、8.0-fpm-alpine

使用场景与适用范围

• PHP 应用开发：适用于 Web 应用、API 服务、命令行脚本等 PHP 项目的本地开发环境
• 调试场景：集成 xdebug 扩展，支持代码断点调试、性能分析等开发功能
• 多环境适配：提供 Alpine 轻量级变体（减小镜像体积）和 FPM 变体（适配 Nginx/Apache 等 Web 服务器）

使用方法与配置说明

拉取镜像

从 Docker Hub 拉取指定版本镜像：

bash
# 拉取 PHP 8.2 标准版本
docker pull columbusinteractive/php-dev:8.2

# 拉取 PHP 8.1 Alpine 轻量版本
docker pull columbusinteractive/php-dev:8.1-alpine

# 拉取 PHP 8.0 FPM 版本（用于 Web 服务器联动）
docker pull columbusinteractive/php-dev:8.0-fpm

运行容器示例

基础命令行交互

bash
# 启动交互式容器并查看 PHP 版本
docker run -it --rm columbusinteractive/php-dev:8.2 php -v

FPM 服务部署

用于与 Web 服务器（如 Nginx）联动：

bash
# 启动 FPM 容器并映射 9000 端口
docker run -d -p 9000:9000 --name php-dev-fpm columbusinteractive/php-dev:8.2-fpm

Composer 配置

默认配置

镜像已全局安装 Composer v2，可直接使用：

bash
docker run -it --rm columbusinteractive/php-dev:8.2 composer --version

切换至 Composer v1

如需使用 Composer v1，可在 Dockerfile 中通过以下方式覆盖：

dockerfile
# 从官方 Composer v1 镜像复制二进制文件
COPY --from=composer:1 /usr/bin/composer /usr/local/bin/composer

贡献指南

• 问题反馈：发现问题或功能需求，请在 https://github.com/columbusinteractive/docker-php 提交 issue 并提供详细信息（问题描述越具体，越便于定位修复）。
• 代码提交：欢迎提交 PR，提交前需运行 make build 和 make test 验证，并遵循 Dockerfile 最佳实践。

许可协议

本项目基于 https://github.com/columbusinteractive/docker-php/blob/master/LICENSE 开源。

项目来源

本仓库及文件基于 https://github.com/chialab/docker-php 的工作成果构建。