Phabricator 官方教程

1. 项目介绍

Phabricator 是一套基于 Web 的开发协作工具集，主要功能包括代码审查（Differential）、版本库浏览（Diffusion）、变更监控（Herald）、任务管理（Maniphest）以及知识库（Phriction）。它支持 Git、Mercurial 和 Subversion 版本控制系统，并以 Apache 许可证开源。最初由 Facebook 内部开发，后来由 Phacility 公司维护，尽管 Phacility 在 2021 年停止了对 Phabricator 的更新，但存在社区分支如 Phorge 继续维护。

2. 项目快速启动

环境准备

确保你的服务器上已经安装了以下软件：

• PHP：版本 >= 5.6
• MySQL 或 PostgreSQL 数据库
• Git
• Composer

安装步骤

1. 使用 git 克隆项目仓库：

   git clone https://github.com/phacility/phabricator.git
   

2. 进入项目目录：

   cd phabricator
   

3. 安装依赖：

   composer install --no-dev
   

4. 初始化配置文件：

   ./bin/config generate-secret
   ./bin(phabricator-configuration-bootstrap)
   

5. 配置数据库连接，编辑 .env.local.properites 文件并填入相应的数据库连接信息。

6. 创建数据库： 根据选择的数据库系统执行相应的命令。例如，对于 MySQL：

   mysql -u root -p < arcanist/local/local.mysql.sql
   

7. 启动 Phabricator 服务：

   ./bin/storage upgrade
   ./bin/cron
   ./bin/console phd start
   

8. 打开浏览器访问 Phabricator 安装向导：http://yourserver.com/setup/index.php 按照提示完成设置。

3. 应用案例和最佳实践

Phabricator 被广泛应用于多个知名公司，比如 Facebook、Twitter、Mozilla 和 Kubernetes 社区等。最佳实践包括：

1. 使用 Differential 进行代码审查：要求团队成员在提交代码前进行代码审查。
2. 通过 Phriction 制定规范和文档：保持团队的开发指南和知识库的最新状态。
3. 利用 Herald 规则自动化工作流：创建自动化规则来处理任务、通知等。
4. 整合外部仓库：可以通过 Diffusion 连接外部 Git 仓库，实现集中化管理。

4. 典型生态项目

Phabricator 支持与其他开源项目集成，例如：

• Kubernetes: 使用 Phabricator 进行集群管理和升级的代码审查。
• AngularJS: 开发和维护过程中使用 Phabricator 的代码审核功能。
• Firefox: Mozilla 团队使用 Phabricator 作为其代码评审平台。
• FreeBSD: 该项目用 Phabricator 来跟踪和协调开发工作。

这些案例展示 Phabricator 如何适应不同规模和技术背景的开源项目，提供高效的合作环境。