brackets/craftable-pipelines

镜像概述

该Docker镜像专为BitBucket Pipelines设计，集成了PHP项目开发与测试所需的核心工具，提供一站式CI/CD环境支持。通过预配置git、php、composer、phpunit和postgresql，简化PHP项目在自动化流程中的环境依赖管理，实现代码拉取、依赖安装、单元测试及数据库交互的全流程支持。

核心功能和特性

集成工具集

• git：版本控制系统，支持代码拉取、提交、分支管理等操作，确保CI流程中代码来源的准确性。
• PHP运行环境：内置PHP解释器，支持PHP代码执行与解析，适配主流PHP版本（具体版本需参考镜像标签）。
• Composer：PHP依赖管理工具，自动解析并安装项目依赖包，支持依赖版本锁定与.lock文件生成，保障环境一致性。
• PHPUnit：PHP单元测试框架，支持编写和执行单元测试用例，生成测试报告，助力代码质量验证。
• PostgreSQL：开源关系型数据库，提供数据库服务支持，可模拟生产环境进行数据库交互测试。

协同能力

工具间无缝集成，支持从代码拉取（git）→ 依赖安装（composer）→ 代码执行（PHP）→ 单元测试（phpunit）→ 数据库交互（postgresql）的完整开发测试链路，满足PHP项目CI/CD全流程需求。

使用场景和适用范围

适用项目类型

• 基于PHP开发的Web应用、API服务或命令行工具项目。
• 使用BitBucket作为代码仓库，并采用BitBucket Pipelines实现CI/CD的项目。

典型应用场景

• 自动化构建：通过git拉取代码后，使用composer安装依赖，完成项目构建。
• 单元测试执行：利用phpunit运行测试用例，验证代码功能正确性。
• 数据库集成测试：连接postgresql数据库，执行涉及数据交互的测试，确保业务逻辑与数据操作一致性。
• 代码质量检查：结合PHP代码分析工具（如PHPStan、PHPCS），在CI流程中自动进行代码规范与质量检查。

使用方法和配置说明

在BitBucket Pipelines中使用

在项目根目录下创建/修改bitbucket-pipelines.yml，指定该镜像作为执行环境。基础配置示例：

yaml
image: docker.xuanyuan.run/<镜像名称>:<标签>  # 替换为实际镜像名称和标签（如php-bitbucket-env:latest）

pipelines:
  default:
    - step:
        name: Build & Test
        script:
          - git --version  # 验证git安装
          - php --version   # 验证PHP环境
          - composer install  # 安装项目依赖
          - composer dump-autoload  # 生成自动加载文件
          - service postgresql start  # 启动PostgreSQL服务（根据镜像配置调整）
          - psql -U postgres -c "CREATE DATABASE test_db;"  # 创建测试数据库
          - phpunit --configuration phpunit.xml  # 执行单元测试

本地测试（可选）

如需本地验证环境，可通过docker run启动容器：

bash
docker run -it --rm <镜像名称>:<标签> /bin/bash

进入容器后验证工具及执行基础操作：

bash
# 验证工具安装
git --version
php --version
composer --version
phpunit --version
psql --version

# 示例工作流
git clone <项目仓库URL>
cd <项目目录>
composer install  # 安装依赖
service postgresql start  # 启动数据库
psql -U postgres -c "CREATE DATABASE test_db;"  # 创建测试库
phpunit  # 执行单元测试

注意事项

• 版本兼容性：根据项目PHP版本需求选择对应镜像标签，避免工具版本冲突。
• PostgreSQL配置：默认需手动启动服务并初始化数据库（如创建用户、测试库），可通过脚本预设配置。
• 依赖缓存：在bitbucket-pipelines.yml中配置caches字段缓存Composer的vendor目录，提升执行效率：

  yaml
  caches:
    - composer