axistwelve/php

PHP基础构建镜像文档

镜像概述

本镜像为PHP应用开发和构建提供基础环境，基于官方PHP镜像构建，整合标准PHP运行时环境及必要的构建工具，旨在作为各类PHP项目构建流程的基础镜像，简化PHP应用的开发、编译及打包过程。

核心功能和特性

• 基于官方PHP镜像：以官方PHP镜像为基础，确保运行时环境的稳定性和兼容性
• 集成基础构建工具：包含composer、git、curl、zip等常用构建工具，满足PHP项目依赖管理及源码获取需求
• 多PHP版本支持：提供多个PHP版本标签（如7.4、8.0、8.1等），适配不同项目的PHP版本需求
• 轻量级设计：在保证功能的前提下优化镜像体积，减少构建和传输耗时
• 标准化配置：预设基础php.ini配置，支持自定义配置覆盖

使用场景和适用范围

• PHP应用开发环境：作为本地开发环境的基础镜像，提供统一的PHP运行及构建环境
• CI/CD构建流程：在持续集成/持续部署流程中作为基础构建镜像，用于执行代码检查、依赖安装、打包等构建步骤
• PHP库/框架打包：用于PHP库、框架或工具的打包构建，生成可分发的安装包
• 教学/演示环境：作为PHP技术教学或示例项目演示的基础环境，快速搭建标准PHP运行环境

使用方法和配置说明

基本使用

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像名称]:[PHP版本标签]
# 示例：拉取PHP 8.1版本
docker pull docker.xuanyuan.run/[镜像名称]:8.1

2. 基本运行

bash
docker run -it --rm [镜像名称]:8.1 php -v
# 输出PHP版本信息，验证环境是否正常

项目构建示例

1. 挂载项目目录并安装依赖

bash
docker run -it --rm -v $(pwd):/app [镜像名称]:8.1 \
  sh -c "cd /app && composer install"
# 将当前目录挂载到容器内/app目录，执行composer install安装项目依赖

2. 在CI/CD流程中使用（如GitLab CI）

在.gitlab-ci.yml中配置：

yaml
build_job:
  image: docker.xuanyuan.run/[镜像名称]:8.1
  script:
    - composer install --no-dev
    - phpunit tests/
    - tar -czf build.tar.gz ./src ./vendor
  artifacts:
    paths:
      - build.tar.gz

自定义配置

1. 覆盖php.ini配置

bash
docker run -it --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini \
  [镜像名称]:8.1 php -i | grep "Loaded Configuration File"
# 挂载自定义php.ini，覆盖默认配置

2. 指定环境变量

示例：自定义Composer缓存目录

bash
docker run -it --rm -e COMPOSER_HOME=/app/.composer -v $(pwd):/app [镜像名称]:8.1 \
  composer config --list

版本选择

镜像支持的PHP版本标签包括：7.4、8.0、8.1、8.2等，可根据项目需求选择对应标签。

卷挂载

常用卷挂载路径：

• /app：建议挂载项目代码目录
• /root/.composer：Composer缓存目录，挂载可复用依赖缓存，加速依赖安装
• /usr/local/etc/php/conf.d：自定义PHP配置文件目录，挂载后可添加额外ini配置文件

bash
# 挂载项目目录及Composer缓存
docker run -it --rm \
  -v $(pwd):/app \
  -v ~/.composer:/root/.composer \
  [镜像名称]:8.1 \
  composer install