mxmd/php

基于Alpine的跨平台PHP镜像（7.1-8.4）

镜像概述和主要用途

本镜像为基于Alpine Linux构建的PHP Docker镜像，针对CLI（命令行界面）和FPM（FastCGI进程管理器）场景优化，支持PHP 7.1至8.4全版本系列（含各次要版本）。兼容ARM64和x86_64两种主机架构，可无缝集成Laravel等主流PHP框架，适用于PHP应用的开发、测试及生产环境部署。

核心功能和特性

• 跨架构支持：同时兼容ARM64和x86_64硬件架构，满足多平台部署需求
• 多版本覆盖：提供PHP 7.1、7.2、7.3、7.4、8.0、8.1、8.2、8.3系列版本，包含各版本最新次要版本
• 双类型镜像：每个PHP版本均提供CLI（命令行）和FPM（FastCGI进程管理）两种部署类型
• 轻量级基础：基于Alpine Linux，镜像体积小、资源占用低
• 框架兼容：针对Laravel等PHP框架优化，支持开发与生产环境配置
• 灵活扩展：支持挂载自定义PHP配置，通过环境变量调整运行参数

使用场景和适用范围

• PHP应用程序的跨平台开发与部署
• 需要多PHP版本支持的项目（7.1至8.4）
• Laravel等框架构建的Web应用开发与生产环境
• 对镜像体积和资源占用有要求的轻量级部署场景
• 需在ARM64（如Apple Silicon）和x86_64架构间迁移的项目

详细使用方法和配置说明

拉取镜像

使用以下命令拉取特定版本的PHP镜像：

bash
docker pull docker.xuanyuan.run/mxmd/php:<VERSION>-<TYPE>

参数说明：

• <VERSION>：PHP版本，可指定主版本（如7.4，含最新次要版本）或完整次要版本（如7.1.33、8.0.30）
• <TYPE>：镜像类型，cli（命令行）或fpm（FastCGI进程管理器）

示例：拉取PHP 7.4.33 FPM镜像

bash
docker pull docker.xuanyuan.run/mxmd/php:7.4.33-fpm

可用版本及Docker Hub链接：

• https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.1-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.1-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.2-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.2-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.3-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.3-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.4-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=7.4-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.0-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.0-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.1-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.1-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.2-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.2-fpm
• https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.3-cli, https://hub.docker.com/r/mxmd/php/tags?page=1&name=8.3-fpm

Docker Compose配置示例

以下为集成PHP-FPM服务的Docker Compose配置示例：

yaml
services:
  php74-fpm:
    platform: linux/arm64/v8  # 根据主机架构调整（arm64/x86_64）
    image: docker.xuanyuan.run/mxmd/php:7.4.33-fpm  # 指定PHP版本和类型
    ports:
      - "9000:9000"  # FPM默认端口映射
    volumes:
      - .:/app  # 应用代码实时同步
      - ./vendor:/app/vendor:cached  # 依赖目录缓存
      - ./storage:/app/storage:delegated  # 日志/会话目录（容器内为主）
      - ./public:/app/public:cached  # 静态资源缓存
      - ./docker-conf/php-ini:/usr/local/etc/php/custom.d  # 自定义PHP配置
    env_file:
      - .env  # 环境变量文件
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d/:/usr/local/etc/php/custom.d  # 扫描自定义INI
      - COMPOSER_AUTH=${COMPOSER_AUTH}  # Composer认证信息
      - HOST_USER_UID=${HOST_USER_UID:-1000}  # 主机用户UID（Linux必需）
      - HOST_USER_GID=${HOST_USER_GID:-1000}  # 主机用户GID（Linux必需）
      - HOST_ENV=${HOST_ENV:-production}  # 环境标识（生产/开发）
      - EXEC_AS_ROOT=0  # 执行用户（0=www-data，1=root）
  # CLI服务示例
  php74-cli:
    image: docker.xuanyuan.run/mxmd/php:7.4.33-cli
    volumes:
      - .:/app
    environment:
      - HOST_USER_UID=${HOST_USER_UID}
      - HOST_USER_GID=${HOST_USER_GID}

环境变量配置

必需环境变量（Linux主机）

• HOST_USER_UID：主机用户UID，用于权限匹配
• HOST_USER_GID：主机用户GID，用于权限匹配

设置方法（macOS示例）

获取当前用户UID/GID：

bash
id -u  # 获取UID
id -g  # 获取GID

添加到环境变量（~/.bash_profile）：

bash
echo "export HOST_USER_GID=$(id -g)" >> ~/.bash_profile && \
echo "export HOST_USER_UID=$(id -u)" >> ~/.bash_profile && \
source ~/.bash_profile

可选环境变量

• HOST_ENV=production：启用生产环境配置（OPcache、生产级php.ini）
• EXEC_AS_ROOT=1：以root用户执行命令（默认www-data用户）