getwaterfit/v8ms-docker-base

getwaterfit/v8ms-docker-base 镜像文档

镜像概述

getwaterfit/v8ms-docker-base 是一个提供PHP、php-fpm和composer环境的基础Docker镜像，旨在作为微服务开发的基础环境，加速微服务镜像构建流程，并支持在CI/CD（如Bitbucket流水线）中运行测试，确保代码质量与安全性。

核心功能与特性

• 完整PHP环境：内置PHP、php-fpm和composer，满足PHP应用开发、依赖管理及运行需求。
• 构建效率优化：作为基础镜像使用，减少微服务镜像构建时重复的依赖安装步骤，缩短构建周期。
• CI/CD适配：可作为Bitbucket流水线等CI/CD工具的运行环境，在构建最终微服务镜像前执行测试，提前发现潜在问题。
• 安全检查集成：包含 local-php-security-checker 工具（来自 https://github.com/fabpot/local-php-security-checker%EF%BC%89%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%A3%80%E6%B5%8BPHP%E4%BE%9D%E8%B5%96%E5%8C%85%E7%9A%84%E5%B7%B2%E7%9F%A5%E5%AE%89%E5%85%A8%E6%BC%8F%E6%B4%9E%EF%BC%8C%E5%AE%89%E8%A3%85%E8%B7%AF%E5%BE%84%E4%B8%BA /usr/local/bin/local-php-security-checker。

使用场景

• 微服务开发：作为PHP微服务的基础镜像，简化自定义镜像的Dockerfile配置。
• CI/CD流程：在Bitbucket等平台的流水线中运行，执行代码测试与安全检查，确保构建前的代码质量。
• 依赖安全审计：在测试阶段通过工具检查项目依赖的安全状态，避免部署存在已知漏洞的应用。

使用方法与配置说明

基础使用方式

可直接基于此镜像构建自定义微服务镜像，示例Dockerfile：

dockerfile
FROM docker.xuanyuan.run/getwaterfit/v8ms-docker-base:latest
# 自定义配置（如复制项目文件、设置环境变量等）
COPY . /app
WORKDIR /app

安全检查工具使用说明

local-php-security-checker 需在项目的 symfony 目录下运行（依赖该目录中的 composer.lock 文件），以检查已安装PHP包的安全漏洞。执行步骤：

1. 进入容器并切换至 symfony 目录：

   bash
   docker run -it --rm docker.xuanyuan.run/getwaterfit/v8ms-docker-base:latest /bin/bash
   cd /path/to/symfony  # 替换为实际symfony目录路径
   

2. 运行安全检查命令：

   bash
   local-php-security-checker
   

CI/CD集成示例（Bitbucket流水线）

在 bitbucket-pipelines.yml 中配置使用该镜像执行测试与安全检查：

yaml
image: getwaterfit/v8ms-docker-base:latest

pipelines:
  default:
    - step:
        script:
          - cd symfony  # 进入项目symfony目录
          - composer install  # 安装依赖
          - vendor/bin/phpunit  # 执行单元测试（示例）
          - local-php-security-checker  # 运行安全漏洞检查