Composer Docker 镜像文档

镜像概述和主要用途

本镜像是基于 Alpine Linux 的 PHP CLI 环境与 Composer 工具的集成镜像，主要用于 PHP 项目的依赖管理及相关命令行操作。自 2020-01-01 起，镜像默认使用 PHP CLI 环境（早期版本基于 php-fpm 构建），适用于轻量级、高效的 PHP 依赖管理场景。

核心功能和特性

• 轻量级基础：基于 Alpine Linux，具有体积小（镜像尺寸精简）、启动速度快的特点，适合资源受限环境。
• 多架构支持：提供 amd64 和 arm64 架构镜像，适配多种硬件平台。
• 工具集成：内置 PHP CLI 和 Composer，可直接执行 composer 命令及 PHP 脚本。
• 标准化标签：遵循 Jitesoft 镜像标签规范 1.0.0，便于版本管理和识别。

使用场景和适用范围

• 本地开发：快速搭建 PHP 依赖管理环境，执行 composer install、composer update 等命令管理项目依赖。
• CI/CD 流程：在自动化构建 pipeline 中集成，用于项目依赖的自动安装、更新或打包。
• 镜像构建：作为基础镜像，在构建 PHP 应用镜像时预先安装依赖，减少最终镜像体积。
• 跨平台开发：支持 amd64 和 arm64 架构，适配 x86 服务器及 ARM 设备（如树莓派）。

镜像信息

镜像仓库地址

可从以下仓库拉取镜像：

• Docker Hub: jitesoft/composer
• GitLab Container Registry: registry.gitlab.com/jitesoft/dockerfiles/composer-alpine
• GitHub Container Registry: ghcr.io/jitesoft/composer
• Quay.io: quay.io/jitesoft/composer

源码与 Dockerfile

• GitHub: [***]
• GitLab: [***]

使用方法和配置说明

基本使用（docker run）

通过挂载本地项目目录到容器内，执行 Composer 命令：

# 安装项目依赖（当前目录挂载到容器 /app，执行 composer install）
docker run --rm -v $(pwd):/app jitesoft/composer install

# 执行 PHP 脚本（如检查 PHP 版本）
docker run --rm jitesoft/composer php -v

# 自定义 Composer 命令（如创建新项目）
docker run --rm -v $(pwd):/app jitesoft/composer create-project laravel/laravel my-project

说明：--rm 选项确保容器退出后自动删除，避免残留临时容器。

Docker Compose 配置示例

在 docker-compose.yml 中定义服务，集成到项目开发环境：

version: '3.8'
services:
  composer:
    image: jitesoft/composer
    volumes:
      - ./:/app  # 挂载项目目录到容器 /app
      - composer-cache:/root/.composer/cache  # 持久化 Composer 缓存
    environment:
      - COMPOSER_HOME=/root/.composer  # 定义 Composer 主目录（默认）
      - PHP_INI_DIR=/etc/php83/cli  # PHP CLI 配置目录（根据实际 PHP 版本调整）

volumes:
  composer-cache:  # 命名卷用于缓存，加速依赖安装

使用时执行：

docker-compose run --rm composer install  # 安装依赖
docker-compose run --rm composer update   # 更新依赖

环境变量配置

配置文件挂载

通过挂载自定义配置文件覆盖默认配置：

# 挂载自定义 PHP CLI 配置（如修改内存限制）
docker run --rm -v $(pwd)/php.ini:/etc/php83/cli/php.ini -v $(pwd):/app jitesoft/composer install

# 挂载自定义 Composer 配置（如镜像源配置）
docker run --rm -v $(pwd)/composer.json:/root/.composer/composer.json -v $(pwd):/app jitesoft/composer install

许可证信息

• 本仓库文件：MIT 许可证
• Composer：MIT 许可证
• PHP：PHP 许可证

赞助信息

Jitesoft 镜像通过 GitLab CI 在以下机构提供的 runner 上构建：

• 俄勒冈州立大学开源实验室（OSUOSL）

如需赞助或咨询，可联系：***，或通过 Open Collective、GitHub Sponsors 支持项目开发。