Orangescrum 社区版开源项目安装与配置指南

1. 目录结构及介绍

Orangescrum 社区版基于CakePHP框架构建，其目录结构设计以清晰和模块化为原则，便于维护和扩展。以下是主要目录及其功能简介：

• app: 应用核心目录，包含了模型（Models）、控制器（Controllers）、视图（Views）以及配置等子目录。
• • Config: 包含数据库连接配置、常量定义和其他应用配置文件。
  • Controller: 存放所有的控制器类文件。
  • Model: 包括应用程序的所有数据模型。
  • View: 视图模板，展示给用户的界面逻辑。
• lib: 第三方库和框架相关的代码，如CakePHP的核心组件。
• plugins: 可插拔功能目录，允许添加和移除额外的功能模块。
• vendors: 第三方依赖库存放处。
• webroot: 网站的入口，包括静态资源如CSS、JavaScript和访问路由的起点index.php。

2. 项目的启动文件介绍

项目的启动流程主要由Apache服务器或兼容服务器处理，通过URL请求最终到达webroot/index.php。此文件作为前端控制器，它初始化CakePHP框架环境，加载自动路由以及处理请求到相应的控制器动作。在部署时，确保服务器正确配置了URL重写规则（通常通过启用mod_rewrite并使用.htaccess），以支持“无文件名”的URL路径。

3. 项目的配置文件介绍

3.1 数据库配置 (app/Config/database.php)

• 此文件是设置数据库连接的关键。默认情况下，它预设了一个名为“Orangescrum”的数据库连接。你需要根据自己的MySQL设置修改用户名、密码以及数据库名。例如，如果你的数据库名为不同的名称，需在此处进行调整。

3.2 常量配置 (app/Config/constants.php)

• 这个文件用于存储项目中常用的全局常量，如SMTP邮件发送所需的邮箱认证信息（SMTP_UNAME, SMTP_PWORD）。确保设定有效的邮箱发送服务（Gmail、Sendgrid或Mandrill）配置，并指定FROM_EMAIL_NOTIFY和SUPPORT_EMAIL这些必填项，以便系统能够正确发送通知和客服邮件。

3.3 主配置 (app/Config/core.php)

• 虽然题目未特别提及，但core.php同样重要，它涉及缓存设置、错误报告、安全配置等。虽然对于快速启动不是必需直接编辑的，但它对高级配置和安全性有重要作用。

初始化与权限设置

为了使Orangescrum正常运行，还需确保以下目录具有适当的写权限：

• app/Config (在安装完成后可调整回更安全的权限)
• app/tmp
• app/webroot

记得完成所有配置后，通过Web浏览器访问相应地址来启动安装程序，并按指示完成安装步骤。

请注意，实际操作时应遵循最佳安全实践，对于生产环境，避免使用过于宽松的权限设置，比如持续使用chmod 777，并考虑使用更细粒度的权限管理。