convertiv/build

集成Composer与Node.js的基础构建镜像

镜像概述

本镜像为基础构建环境解决方案，集成了PHP依赖管理工具Composer和前端开发环境Node.js/npm，旨在为需要同时处理PHP后端依赖和前端资源构建的项目提供统一的构建工具链，简化多语言项目的构建流程。

核心功能和特性

核心功能

• 集成Composer：内置PHP依赖管理工具，支持composer install、composer update等PHP依赖安装与管理操作
• 集成Node.js/npm：包含Node.js运行时及npm包管理器，支持npm install、npm run build等前端资源构建命令

主要特性

• 多工具整合：避免构建流程中频繁切换PHP和Node.js环境，减少环境配置复杂度
• 基础构建环境：包含基础系统工具（如git、curl等），满足常见构建命令需求
• 轻量级设计：基于精简基础镜像构建，平衡功能与镜像体积
• 版本一致性：固定工具版本，确保构建结果可复现

使用场景和适用范围

适用场景

• 全栈PHP项目构建：需同时处理PHP依赖安装和前端资源打包（如Webpack、Gulp构建）的项目
• CI/CD流水线：作为自动化构建流程中的基础环境，用于持续集成阶段的依赖安装与资源构建
• 本地开发环境：确保团队成员使用统一的构建工具版本，减少"环境不一致"问题
• 混合项目构建：包含PHP后端和JavaScript/TypeScript前端的混合技术栈项目

适用范围

• PHP开发者与前端开发者协作的团队项目
• 包含前端构建流程的PHP框架项目（如Laravel、Symfony）
• 需要自动化构建的中小型Web应用
• 各类CI/CD平台（Jenkins、GitLab CI、GitHub Actions等）

使用方法和配置说明

基本使用

执行Composer命令

在项目根目录下挂载并运行Composer命令：

bash
docker run --rm -v $(pwd):/app [镜像名称] composer install --no-dev

执行npm命令

运行npm安装依赖或构建命令：

bash
# 安装前端依赖
docker run --rm -v $(pwd):/app [镜像名称] npm install

# 执行构建脚本
docker run --rm -v $(pwd):/app [镜像名称] npm run build

交互式操作

进入容器进行多步骤构建操作：

bash
docker run -it --rm -v $(pwd):/app [镜像名称] /bin/sh

CI/CD配置示例（GitLab CI）

在.gitlab-ci.yml中配置构建阶段：

yaml
stages:
  - build

build:
  stage: build
  image: [镜像名称]:latest
  script:
    - composer install --optimize-autoloader --no-dev
    - npm install
    - npm run production
  artifacts:
    paths:
      - vendor/
      - public/assets/

高级配置

自定义工作目录

通过-w参数指定工作目录：

bash
docker run --rm -v $(pwd):/my-project -w /my-project [镜像名称] composer install

配置工具镜像源

通过环境变量设置国内镜像源加速：

bash
# 配置Composer镜像
docker run --rm -v $(pwd):/app -e COMPOSER_MIRROR=https://mirrors.aliyun.com/composer/ [镜像名称] composer install

# 配置npm镜像
docker run --rm -v $(pwd):/app -e NPM_REGISTRY=https://registry.npmmirror.com [镜像名称] npm install

持久化依赖缓存

在CI环境中缓存依赖以提高构建速度：

yaml
# GitLab CI缓存配置示例
cache:
  paths:
    - vendor/
    - node_modules/