首页
/ Phabricator 官方教程

Phabricator 官方教程

2024-08-10 23:14:33作者:翟萌耘Ralph

1. 项目介绍

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

2. 项目快速启动

环境准备

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

  • PHP:版本 >= 5.6
  • MySQLPostgreSQL 数据库
  • 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 如何适应不同规模和技术背景的开源项目,提供高效的合作环境。

登录后查看全文
热门项目推荐
相关项目推荐