Phabricator 项目使用教程
1. 项目的目录结构及介绍
Phabricator 是一个集成了代码审查、仓库浏览、问题跟踪和维基等功能的开发协作工具套件。以下是其主要目录结构及其功能介绍:
- bin: 包含用于启动和管理 Phabricator 服务的脚本。
- src: 包含 Phabricator 的核心代码。
- applications: 包含各种应用的代码,如 Differential(代码审查)、Maniphest(任务管理)等。
- externals: 包含外部库和工具。
- templates: 包含各种模板文件。
- conf: 包含配置文件和示例配置。
- support: 包含支持文件和脚本。
- webroot: 包含 Web 服务器的入口文件。
2. 项目的启动文件介绍
Phabricator 的启动主要依赖于 bin
目录下的脚本。以下是一些关键的启动文件:
- bin/storage_upgrade: 用于升级数据库架构。
- bin/phd: 用于管理后台任务。
- bin/aphront: 用于启动 Web 服务器。
要启动 Phabricator,通常需要执行以下步骤:
- 确保所有依赖项已安装。
- 运行
bin/storage_upgrade
以确保数据库是最新的。 - 启动后台任务:
bin/phd start
。 - 启动 Web 服务器:
bin/aphront start-server
。
3. 项目的配置文件介绍
Phabricator 的配置文件主要位于 conf/
目录下。以下是一些关键的配置文件:
- conf/local/local.json: 主要的配置文件,包含数据库连接、邮件设置、安全设置等。
- conf/default.conf.php: 默认配置文件,包含一些基本设置和示例配置。
在 local.json
中,你可以配置以下内容:
- mysql.host: 数据库主机地址。
- mysql.user: 数据库用户名。
- mysql.pass: 数据库密码。
- phabricator.base-uri: 项目的根 URL。
- storage.local-disk.path: 本地存储路径。
示例 local.json
配置:
{
"mysql.host": "localhost",
"mysql.user": "phabricator",
"mysql.pass": "password",
"phabricator.base-uri": "http://yourdomain.com/",
"storage.local-disk.path": "/path/to/storage"
}
确保在修改配置文件后,重启 Phabricator 以使更改生效。