PHP 8.1 GitHub Actions 专用镜像

镜像概述

本Docker镜像基于官方php:8.1镜像构建，额外集成了运行GitHub Actions工作流所需的核心依赖组件，旨在为PHP项目提供稳定、高效的CI/CD执行环境，简化GitHub Actions中PHP相关任务（如代码拉取、依赖安装、测试执行等）的配置流程。

核心功能与特性

• 基础环境：继承自官方php:8.1镜像，确保PHP 8.1运行环境的兼容性和稳定性
• 系统工具集成：包含GitHub Actions运行必需的系统工具，如git（代码拉取）、curl/wget（依赖下载）、unzip（解压文件）等
• PHP依赖管理：预装Composer工具，支持PHP项目依赖的快速安装与管理
• 常用扩展支持：默认启用PHP核心扩展（如mbstring、xml、json、zip等），满足多数PHP项目基础需求
• CI/CD适配：优化镜像层结构，减少GitHub Actions工作流中的拉取时间，支持环境变量动态注入

使用场景

• GitHub Actions工作流中PHP项目的自动化构建流程
• PHP单元测试（PHPUnit）、集成测试的自动化执行
• PHP代码质量检查（如PHPStan、PHPCS、PHP-CS-Fixer）
• PHP应用打包与部署前的预处理（如资产编译、配置文件生成）

使用方法与配置说明

基础使用（Docker Run）

通过以下命令启动容器并执行PHP任务（以运行PHPUnit测试为例）：

docker run --rm \
  -v $(pwd):/github/workspace \  # 挂载当前工作目录到容器内GitHub工作区
  -w /github/workspace \         # 设置工作目录
  [镜像名称] \                   # 替换为实际镜像名称或标签
  php vendor/bin/phpunit         # 执行PHPUnit测试命令

环境变量配置

支持通过环境变量自定义运行行为，常用配置如下：

示例：自定义Composer缓存目录

docker run --rm \
  -e COMPOSER_HOME=/tmp/composer \
  -v $(pwd):/github/workspace \
  -w /github/workspace \
  [镜像名称] \
  composer install

Docker Compose配置示例

创建docker-compose.yml文件，定义PHP任务服务：

version: '3.8'

services:
  php-ci:
    image: [镜像名称]  # 替换为实际镜像名称或标签
    volumes:
      - .:/github/workspace
    working_dir: /github/workspace
    environment:
      - COMPOSER_HOME=/tmp/composer
      - PHP_INI_DIR=/usr/local/etc/php
    command: php vendor/bin/phpunit  # 默认执行PHPUnit测试

启动服务：

docker-compose run --rm php-ci

GitHub Actions工作流集成示例

在.github/workflows/php-test.yml中使用该镜像：

name: PHP Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run PHP tests with custom image
        uses: docker://[镜像名称]  # 替换为实际镜像名称或标签
        with:
          args: php vendor/bin/phpunit

扩展安装说明

如需额外PHP扩展，可通过docker-php-ext-install命令在容器启动时安装（需确保基础依赖已满足）：

docker run --rm \
  -v $(pwd):/github/workspace \
  -w /github/workspace \
  [镜像名称] \
  sh -c "apt-get update && apt-get install -y libpq-dev && docker-php-ext-install pdo_pgsql && php vendor/bin/phpunit"