xseedingbv/php

PHP与Composer CI/CD专用Docker镜像

镜像概述

本Docker镜像提供多种PHP版本与预安装的Composer工具，旨在简化PHP项目在CI/CD（持续集成/持续部署）流水线中的环境配置。通过统一的镜像环境，确保不同CI/CD环节（如依赖安装、代码测试、构建打包）使用一致的PHP运行时和依赖管理工具，减少环境差异导致的问题。

核心功能与特性

• 多PHP版本支持：提供多种稳定PHP版本（如7.2、7.3、7.4、8.0、8.1、8.2等），满足不同项目的兼容性需求
• Composer集成：预安装最新稳定版Composer，支持依赖安装、更新、打包等操作
• 轻量级设计：基于官方PHP镜像优化，减少冗余组件，适合CI/CD环境快速拉取和启动
• CI/CD适配：兼容主流CI/CD工具（GitLab CI、GitHub Actions、Jenkins、CircleCI等），支持非交互式运行
• 扩展支持：包含常用PHP扩展（如mbstring、json、curl、xml等），满足多数PHP项目基础依赖

使用场景

• PHP项目的依赖安装与更新（composer install/update）
• 代码静态分析（如PHPStan、Psalm）
• 单元测试与集成测试（如PHPUnit）
• 项目构建与打包（如生成生产环境依赖包）
• CI/CD流水线中的环境一致性验证

使用方法

镜像拉取

通过标签指定PHP版本拉取镜像：

bash
docker pull [镜像仓库地址]/php-composer:php7.4
docker pull [镜像仓库地址]/php-composer:php8.2

注：请将[镜像仓库地址]替换为实际镜像仓库路径

基础使用示例

1. 运行Composer命令（依赖安装）

在项目根目录执行，挂载当前目录到容器内/app路径：

bash
docker run --rm -v $(pwd):/app [镜像仓库地址]/php-composer:php8.1 composer install --no-dev

2. 执行PHP单元测试

bash
docker run --rm -v $(pwd):/app [镜像仓库地址]/php-composer:php7.4 php vendor/bin/phpunit tests/

3. 在GitLab CI中的配置示例（.gitlab-ci.yml）

yaml
stages:
  - dependencies
  - test

install_deps:
  stage: dependencies
  image: [镜像仓库地址]/php-composer:php8.0
  script:
    - composer install --prefer-dist --no-progress
  artifacts:
    paths:
      - vendor/

run_tests:
  stage: test
  image: [镜像仓库地址]/php-composer:php8.0
  script:
    - php vendor/bin/phpunit --coverage-text
  dependencies:
    - install_deps

环境变量配置

自定义配置

如需修改PHP配置，可通过挂载自定义php.ini文件实现：

bash
docker run --rm -v $(pwd):/app -v $(pwd)/custom-php.ini:/usr/local/etc/php/php.ini [镜像仓库地址]/php-composer:php8.1 php -i