modestcoders/php

ModestCoders PHP-FPM 镜像文档

镜像概述

ModestCoders PHP-FPM镜像是基于官方PHP-FPM镜像构建的开发环境镜像，预装Composer（PHP依赖管理工具）和Xdebug（PHP调试扩展），支持多个PHP版本，为PHP应用开发、调试及依赖管理提供便捷环境。

核心功能与特性

• 多PHP版本支持：提供PHP 7.0、7.1、7.2、7.3 FPM版本
• 开发工具集成：
  • 预装Composer，支持PHP项目依赖安装与管理
  • 集成Xdebug扩展，便于PHP代码调试
• 官方基础：基于官方PHP-FPM镜像构建，保证基础环境的稳定性和安全性

可用标签

使用场景

• PHP应用本地开发环境搭建
• 代码调试与问题排查（利用Xdebug）
• PHP项目依赖安装与更新（通过Composer）
• 开发环境一致性保障

使用方法

基本运行

bash
docker run -d --name php-fpm modestcoders/php:7.3-fpm

挂载项目目录

将本地PHP项目挂载到容器中：

bash
docker run -d --name php-fpm -v /本地项目路径:/var/www/html modestcoders/php:7.3-fpm

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  php:
    image: modestcoders/php:7.3-fpm
    volumes:
      - ./项目目录:/var/www/html
    ports:
      - "9000:9000"  # PHP-FPM默认端口
    environment:
      - PHP_INI_DIR=/usr/local/etc/php  # PHP配置文件目录

启动服务：

bash
docker-compose up -d

使用Composer

在容器内执行Composer命令：

bash
# 安装项目依赖
docker exec -it php-fpm composer install

# 更新依赖
docker exec -it php-fpm composer update

或直接运行一次性命令：

bash
docker run --rm -v /本地项目路径:/var/www/html modestcoders/php:7.3-fpm composer install

配置Xdebug

Xdebug已预装，可通过挂载自定义配置文件进行设置。默认配置路径为/usr/local/etc/php/conf.d/xdebug.ini，示例配置：

ini
[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=host.docker.internal
xdebug.client_port=9003

挂载配置文件：

bash
docker run -d --name php-fpm -v /本地xdebug.ini:/usr/local/etc/php/conf.d/xdebug.ini modestcoders/php:7.3-fpm

注意事项

• 该镜像主要面向开发环境，生产环境使用前建议移除Xdebug并优化配置
• 不同PHP版本的扩展支持存在差异，具体以对应版本Dockerfile为准
• Composer依赖缓存可通过挂载/root/.composer/cache目录提高安装速度