shinsenter/magento

shinsenter/magento

镜像概述和主要用途

基于shinsenter/php的Docker镜像，专为Magento Open Source设计，生产就绪，具备自动安装功能。支持通过环境变量轻松配置PHP和PHP-FPM设置，无需重建镜像即可调整配置。包含最新版Composer，便于快速启动项目，提供Debian和Alpine两种版本。

核心功能和特性

• 自动安装：挂载空目录时自动下载Magento源代码，快速初始化新项目
• 灵活配置：通过环境变量配置PHP和PHP-FPM，无需修改Dockerfile或重建镜像
• 即开即用：内置最新版Composer，无需额外安装即可管理项目依赖
• 多版本支持：提供Debian和Alpine两种基础镜像版本，满足不同环境需求
• HTTPS支持：包含预生成SSL测试证书，支持替换为自定义证书以启用生产环境HTTPS
• 持续更新：每日构建确保包含PHP、基础系统、Composer等最新上游更新

使用场景和适用范围

• 快速搭建新的Magento Open Source项目开发环境
• 部署现有Magento应用到测试或生产环境
• 需要灵活调整PHP配置而不想重建镜像的场景
• 追求轻量级（Alpine）或兼容性（Debian）部署的Magento项目

详细使用方法和配置说明

创建新项目

当挂载空目录到容器时，镜像会自动下载Magento源代码，快速完成项目初始化。

操作步骤：

1. 在主机创建空目录用于存放项目代码：

shell
mkdir magento

2. 运行容器并挂载该目录作为卷：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./magento:/var/www/html \
    docker.xuanyuan.run/shinsenter/magento:latest

容器会检测到空目录并自动克隆Magento框架源代码到挂载卷中。

使用现有项目

挂载主机上的现有Magento代码目录到容器的/var/www/html路径即可运行现有项目：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/your/existing/magento:/var/www/html \
    docker.xuanyuan.run/shinsenter/magento:latest

挂载后，主机上的代码修改会实时同步到容器内，便于开发和测试。

配置HTTPS

镜像默认包含预生成的SSL测试证书，生产环境需替换为自定义证书。

使用Dockerfile配置

Dockerfile
FROM docker.xuanyuan.run/shinsenter/magento:latest

# 复制自定义证书到容器
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：添加项目代码到容器（如需内置代码）
# ADD --chown=$APP_USER:$APP_GROUP ./magento/ /var/www/html/

使用docker run配置

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./magento:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    docker.xuanyuan.run/shinsenter/magento:latest

使用docker-compose配置

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/magento:latest
    volumes:
      - ./magento:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"

稳定镜像标签管理

由于每日构建会更新相同标签的镜像内容，为确保生产环境稳定性，建议：

1. 拉取最新镜像并标记为稳定版本：

shell
docker pull docker.xuanyuan.run/shinsenter/magento:latest
docker tag shinsenter/magento:latest your-repo/magento:stable
docker push your-repo/magento:stable

2. 在生产环境中使用标记的稳定镜像：

shell
docker run -p 80:80 -p 443:443 \
    -v ./magento:/var/www/html \
    docker.xuanyuan.run/your-repo/magento:stable

贡献方式

如发现镜像有用，可通过***，或在https://code.shin.company/php/issues/new提交issue反馈问题。

许可协议

本项目采用https://code.shin.company/php/blob/main/LICENSE许可协议。

来自越南 🇻🇳 的爱。