aubergineit/pipelines-php

PHP流水线优化镜像

镜像概述

本镜像基于官方PHP镜像构建，通过预装一系列开发及构建工具，旨在为PHP项目的流水线（Pipeline）运行提供开箱即用的环境。镜像集成了常用PHP扩展、依赖管理工具（Composer）、前端构建环境（Node.js、Gulp、Yarn），可有效减少流水线中依赖安装步骤，提升运行效率，确保环境一致性。

核心功能与特性

预装组件

• PHP扩展：包含PHP项目开发常用扩展（具体扩展基于官方PHP镜像基础扩展集，可根据官方PHP镜像标签版本确定）
• 依赖管理：预装Composer（PHP依赖管理工具）
• Node.js环境：集成Node.js运行时，支持JavaScript相关构建任务
• 前端构建工具：包含Gulp（任务自动化工具）及Yarn（JavaScript包管理器）

核心优势

• 即开即用：无需手动安装基础依赖，直接用于流水线任务
• 效率提升：减少流水线中依赖下载与安装环节，缩短运行时间
• 环境一致：统一开发与构建环境，降低"本地正常、流水线异常"的环境差异问题

使用场景与适用范围

• CI/CD流水线：适用于Jenkins、GitLab CI、GitHub Actions等各类CI/CD平台的PHP项目构建、测试及部署流程
• PHP项目构建：支持基于Composer的依赖安装、PHP代码静态分析、单元测试等任务
• 前端资源处理：可通过Node.js、Gulp、Yarn完成PHP项目中前端资源（CSS/JavaScript）的编译、压缩等构建流程
• 本地开发测试：作为本地一致的开发环境，模拟流水线构建过程

使用方法与配置说明

基本使用（docker run）

通过以下命令启动容器，可直接进入交互式终端验证环境：

bash
docker run -it --rm [镜像名称]:[标签] /bin/bash

说明：[镜像名称]为实际镜像名称，[标签]通常对应基础PHP版本（如7.4、8.0等）

Docker Compose配置示例

在项目中创建docker-compose.yml文件，集成该镜像到本地开发或构建环境：

yaml
version: '3'
services:
  pipeline-php:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    volumes:
      - ./:/app  # 挂载项目目录到容器内/app
    working_dir: /app  # 设置工作目录
    command: composer install && npm install && gulp build  # 示例：执行依赖安装与构建命令

执行以下命令启动服务并运行构建任务：

bash
docker-compose up

配置参数与环境变量

当前镜像暂无特定环境变量或配置参数，可直接基于基础PHP镜像的配置方式进行自定义（如通过php.ini配置PHP参数，或通过命令行参数覆盖默认命令）。

注意事项

• 镜像标签建议与项目所需PHP版本保持一致，避免版本兼容性问题
• 若需额外PHP扩展，可基于此镜像通过Dockerfile进一步定制构建
• 敏感信息（如Composer镜像源、NPM镜像源）建议通过外部配置或挂载方式注入，避免硬编码到镜像中