mappia/magento-php

Magento 2 专用PHP镜像

镜像概述

本镜像为基于Alpine的轻量级PHP镜像，专为Magento 2应用设计。已预先配置生产环境所需的全部PHP扩展，可直接用于Magento 2的生产部署。

核心功能与特性

镜像变体

• cli: 适用于命令行操作，如Magento安装部署、定时任务(cron)及索引管理等场景。
• fpm: 适用于通过PHP-FPM处理Web请求，配合Nginx等Web服务器提供Magento 2前端服务。

PHP版本

当前支持的PHP版本标签格式为：cli-alpine8.4（其中8.4为PHP版本号）。

镜像标签类型

• Evergreen标签：如cli-alpine8.4，每周更新，始终包含最新安全补丁和优化。
• Mappia版本化标签：如v0.7.1-cli-alpine8.4，固定镜像摘要，发布后内容不再变更，适合需要版本稳定性的场景。
• 日期标签：如20250421-cli-alpine8.4，固定镜像摘要，每7天更新一次，提供时间维度的版本控制。

使用场景与适用范围

• Magento 2生产环境部署
• Magento 2命令行任务执行（如索引更新、数据迁移）
• 基于PHP-FPM的Magento 2 Web服务搭建
• 需要轻量级PHP环境的Magento 2开发/测试（生产配置）

使用方法与配置说明

标签选择建议

• 生产环境追求稳定性：选择Mappia版本化标签（如v0.7.1-cli-alpine8.4）
• 需要定期获取安全更新：选择Evergreen标签（如cli-alpine8.4）
• 需明确版本时间线：选择日期标签（如20250421-cli-alpine8.4）

基础使用示例

CLI变体（命令行操作）

bash
docker run --rm -v /path/to/magento:/app mappia/magento-php:cli-alpine8.4 bin/magento setup:upgrade

FPM变体（Web服务）

配合Nginx使用时，典型docker-compose.yml配置片段：

yaml
services:
  php-fpm:
    image: mappia/magento-php:fpm-alpine8.4
    volumes:
      - /path/to/magento:/app
    environment:
      - PHP_MEMORY_LIMIT=2G
  
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - /path/to/magento:/app
      - /path/to/nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm

版本管理说明

• Evergreen标签：每周自动更新，包含最新安全补丁和依赖更新
• 版本化标签：发布后永久不变，镜像摘要固定，适合生产环境版本锁定
• 日期标签：每7天生成新标签，保留历史版本，便于回滚操作