heycart/docker-base

HeyCart 6 Production Docker镜像文档

镜像概述

HeyCart 6 Production Docker是一个预配置的基础镜像，集成了Alpine Linux、PHP运行环境以及Web服务器（Caddy或Nginx），旨在为用户提供便捷的基础环境，用于构建包含自身应用代码的Docker镜像。

核心功能和特性

• 轻量级基础：基于Alpine Linux，具有体积小、资源占用低的特点，适合高效部署
• 完整PHP环境：内置PHP运行环境，支持PHP应用程序的运行和调试
• Web服务器选项：提供Caddy或Nginx两种Web服务器选择，满足不同应用场景的部署需求
• 易于扩展：可作为基础镜像直接使用，方便集成用户自定义应用代码、配置文件及依赖

使用场景和适用范围

适用于需要构建基于PHP的Web应用Docker镜像的场景，包括：

• 开发环境中快速构建应用镜像进行本地测试
• 生产环境中标准化部署PHP Web应用
• 需要轻量级基础环境的PHP应用容器化项目
• 需灵活选择Web服务器（Caddy或Nginx）的PHP应用场景

使用方法和配置说明

基础使用流程

通过将该镜像作为基础镜像，在Dockerfile中集成用户应用代码，构建自定义应用镜像。

示例Dockerfile

dockerfile
# 选择基础镜像，可通过标签指定Web服务器（Caddy或Nginx）
# 例如：使用Caddy服务器
FROM heycart6-production:caddy
# 或使用Nginx服务器
# FROM heycart6-production:nginx

# 复制用户应用代码到Web服务器文档根目录
COPY ./your-app-code /var/www/html

# （可选）添加自定义Web服务器配置
# 若使用Nginx，复制自定义配置
# COPY ./custom-nginx.conf /etc/nginx/conf.d/default.conf
# 若使用Caddy，复制自定义Caddyfile
# COPY ./Caddyfile /etc/caddy/Caddyfile

# （可选）安装应用所需的额外依赖
RUN apk add --no-cache php-mysqli  # 示例：安装PHP MySQLi扩展

# 暴露Web服务端口（根据Web服务器配置，通常为80或443）
EXPOSE 80

构建应用镜像

在包含上述Dockerfile的项目根目录执行以下命令，构建集成用户代码的应用镜像：

bash
docker build -t my-php-webapp .

运行应用容器

构建完成后，通过以下命令启动应用容器：

bash
# 映射容器80端口到主机8080端口
docker run -d -p 8080:80 --name my-webapp-container my-php-webapp

注意事项

• Web服务器选择：通过镜像标签指定使用Caddy（如:caddy）或Nginx（如:nginx），未指定标签时请参考官方文档确认默认Web服务器
• 配置文件路径：根据所选Web服务器，确保自定义配置文件复制到正确路径（Nginx通常为/etc/nginx/conf.d/，Caddy通常为/etc/caddy/）
• 文档根目录：默认Web服务器文档根目录通常为/var/www/html，需确保用户代码复制到此路径或修改配置文件指定正确路径
• 依赖管理：如需额外PHP扩展或系统依赖，可通过RUN apk add命令在Dockerfile中安装