explicit-architecture-php部署指南：Docker环境下的Symfony架构应用最佳配置

【免费下载链接】explicit-architecture-phpThis repository is a demo of Explicit Architecture, using the Symfony Demo Application.项目地址: https://gitcode.com/gh_mirrors/ex/explicit-architecture-php

explicit-architecture-php是一个基于Symfony框架的显式架构演示项目，通过Docker容器化部署可以快速搭建开发和生产环境。本指南将带你完成从环境准备到应用启动的全流程，让你轻松掌握显式架构应用的部署技巧。

📋 环境准备与依赖检查

在开始部署前，请确保你的系统已安装以下工具：

• Docker Engine (20.10+)
• Docker Compose (v2+)
• Git

项目采用Makefile管理部署流程，核心容器配置位于build/container/目录，包含开发、测试和生产环境的完整配置。

🏗️ 项目架构概览

explicit-architecture-php采用分层架构设计，主要包含以下核心模块：

图：显式架构各层依赖关系，展示Domain、Port、Application和Infrastructure的交互流程

核心代码目录结构：

• src/Core/- 包含领域模型和核心业务逻辑
• src/Infrastructure/- 外部服务集成实现
• src/Presentation/- Web和控制台界面
• config/- 应用配置文件

🚀 快速部署步骤

1. 克隆项目代码

git clone https://gitcode.com/gh_mirrors/ex/explicit-architecture-php cd explicit-architecture-php

2. 构建Docker镜像

项目提供了完整的Docker构建流程，通过Makefile可以一键构建基础镜像：

# 构建基础镜像 make box-build-base # 构建开发环境镜像 make box-build-dev

3. 安装依赖与配置数据库

# 安装PHP依赖 make dep-install # 初始化数据库 make db-setup

db-setup命令会自动执行以下操作：

• 创建SQLite数据库文件（位于var/data/blog.sqlite）
• 执行数据库迁移
• 加载测试数据

4. 启动开发服务器

# 启动开发环境 make up

服务启动后，可通过http://localhost访问应用。开发环境配置文件位于build/container/dev/docker-compose.yml。

⚙️ 生产环境配置

构建生产镜像

# 构建生产环境镜像 make box-build-prd # 推送镜像到仓库（需Docker登录） make box-push-prd

生产环境会自动优化依赖加载，仅保留必要的生产依赖，并禁用调试工具。

启动生产服务

# 启动生产环境 make up-prd

生产环境配置文件位于build/container/prd/docker-compose.yml，默认启用更严格的安全设置和性能优化。

🔍 架构组件详解

项目采用显式架构设计，各组件间通过明确的接口通信：

图：架构组件间的依赖关系，展示核心业务组件的交互方式

关键组件说明：

• Domain- 核心业务实体和规则，如src/Core/Component/Blog/Domain/Post/Post.php
• Port- 定义外部依赖接口，如src/Core/Port/Persistence/QueryInterface.php
• Infrastructure- 实现外部依赖，如src/Infrastructure/Persistence/Doctrine/DqlQuery.php

🧪 测试与验证

项目提供了完整的测试套件，可通过以下命令运行：

# 运行单元测试 make test # 运行验收测试 make test-acc # 生成依赖关系图 make test-dep-graph

测试结果和覆盖率报告将生成在var/目录下。

💡 常见问题解决

1. 数据库连接问题：检查config/packages/doctrine.yaml中的数据库配置
2. 依赖安装失败：确保网络连接正常，可尝试make dep-clearcache-guest清除Composer缓存
3. 容器启动失败：检查端口占用情况，或使用make box-build-dev重新构建镜像

📚 扩展阅读

• 项目配置文件：config/
• 数据库迁移脚本：src/Core/Component/Blog/Infrastructure/Doctrine/Migrations/
• 开发工具配置：docs/IDE/PHPStorm/

通过以上步骤，你已成功部署explicit-architecture-php应用。这个显式架构示例项目展示了如何在Symfony中实现清晰的分层设计，通过Docker容器化部署可以显著简化环境配置和版本管理。

【免费下载链接】explicit-architecture-phpThis repository is a demo of Explicit Architecture, using the Symfony Demo Application.项目地址: https://gitcode.com/gh_mirrors/ex/explicit-architecture-php