shinsenter/invoiceshelf

🔋 (PHP / InvoiceShelf) 生产就绪的Docker镜像，包含自动InvoiceShelf安装程序。

• Docker Hub: [***]
• GitHub Packages: [***]
• 您还可以在此处找到其他流行PHP应用和框架的预构建Docker镜像：[***]

该Docker镜像提供Debian和Alpine两个版本。

1. 镜像概述和主要用途

shinsenter/invoiceshelf是专为InvoiceShelf应用设计的生产级Docker镜像，集成自动安装程序，可快速部署InvoiceShelf（基于Laravel框架的发票管理系统）。镜像内置PHP和PHP-FPM环境，支持通过环境变量灵活配置，无需重建镜像即可调整应用设置，适用于开发、测试及生产环境。

2. 核心功能和特性

• 自动安装：挂载空目录时自动下载并部署InvoiceShelf源码，快速初始化项目。
• 灵活配置：通过环境变量配置PHP和PHP-FPM参数，无需修改镜像。
• 内置工具：包含最新版Composer，支持依赖管理和项目构建。
• HTTPS支持：预生成测试SSL证书，可替换为生产环境证书。
• Laravel集成：支持数据库自动迁移、队列 worker、调度器等Laravel核心功能，通过环境变量一键启用。
• 多版本支持：提供Debian和Alpine两种基础镜像版本，满足不同资源需求。

3. 使用场景和适用范围

• 快速启动新项目：开发者可通过空目录挂载快速搭建InvoiceShelf开发环境。
• 现有项目部署：挂载本地代码目录，实现开发与容器内运行环境的同步。
• 生产环境部署：支持HTTPS配置、数据库迁移、任务调度等生产必需功能。
• CI/CD集成：作为基础镜像用于自动化构建、测试和部署流程。

4. 详细使用方法和配置说明

4.1 创建新项目

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

步骤：

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

   shell
   mkdir invoiceshelf
   

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

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

容器会检测到/var/www/html挂载的空目录，并自动克隆框架源码到该目录。

4.2 使用现有项目

将主机上的现有应用代码挂载到容器内的/var/www/html目录，实现代码实时同步。主机端修改会立即反映到容器内，支持在容器中运行构建、测试等任务，同时保持代码在主机端管理。

示例命令：

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

4.3 HTTPS配置

镜像内置测试用SSL证书（路径：/etc/ssl/site/server.crt和/etc/ssl/site/server.key），生产环境需替换为有效证书。以下是三种替换方式：

4.3.1 使用Dockerfile

dockerfile
FROM shinsenter/invoiceshelf: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 ./invoiceshelf/ /var/www/html/

4.3.2 使用docker run命令

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

4.3.3 使用docker-compose

yaml
services:
  web:
    image: shinsenter/invoiceshelf:latest
    volumes:
      - ./invoiceshelf:/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"

5. 环境变量配置

通过以下环境变量可配置Laravel相关服务（如数据库迁移、队列、调度器等）：

6. 稳定镜像标签

由于每日构建更新（以同步PHP、基础系统、Composer等上游更新），同一源码构建的Docker镜像可能不完全一致。建议通过以下命令标记稳定版本：

shell
# 拉取最新镜像
docker pull shinsenter/invoiceshelf:latest

# 标记为稳定版本
docker tag shinsenter/invoiceshelf:latest your-repo/invoiceshelf:stable

# 推送到私有仓库（如需要）
docker push your-repo/invoiceshelf:stable

生产环境建议使用标记的稳定版本（如your-repo/invoiceshelf:stable）作为基础镜像。

7. 相关资源和贡献

• 文档：[***]
• 贡献：如发现问题，可通过GitHub提交issue：[***]
• ：支持项目维护可通过：[**]

8. 许可协议

本项目基于GNU General Public License v3.0许可。使用或基于本项目构建时，请注明出处。

---

来自越南 🇻🇳 的爱。