Phabricator 入门教程

墨蓝 2022-04-23 13:44 134阅读 0赞

[Phabricator][] 是一款用于敏捷开发的项目管理软件，它集成了众多实用功能，包括：

*  代码管理：添加 Git, Mercurial 和 SVN 仓库，查看源码，review 代码
 *  bug 追踪：测试人员、开发人员协同工作
 *  项目管理：项目的启动、进展、完成
 *  工作板：所有任务一目了然
 *  wiki：构建文档
 *  任务系统：创建任务、指派任务、完成任务、增加或降低优先级
 *  博客系统：甚至可以写博客

[![3cb125c9507f2890336d77ddbb6f335c.png][]][3cb125c9507f2890336d77ddbb6f335c.png]

这里介绍如何从零开始，完成 Phabricator 的安装配置，设置[数据库][Link 1]和发送邮件配置，仅供参考。

## 前提条件 ##

Phabricator 的运行环境是 php，数据库采用 mysql，web服务器可选 nginx、apache、lighttpd等。

如果操作系统为 ubuntu ，希望快速安装，可以拷贝 [install\_ubuntu.sh][install_ubuntu.sh] 脚本，一键安装 php5、apache、mysql-server。

这里安装 php5 (包括所需扩展)、nginx、mysql-server。

sudo apt-get update
    sudo apt-get install php5 php5-mysql php5-gd php5-dev php5-curl php-apc php5-cli php5-json nginx mysql-server

## Tips：[PHP][] 7 的兼容性 ##

如果你的环境是PHP 7.0，那么恭喜你，Phabricator 无法运行在 PHP 7.0 下。

Phabricator 支持 5.x 版本以及 7.1 以上版本，唯独不支持 7.0。

据 [官方声明][Link 2] ，Phabricator 依赖的异步信号处理特性，在 7.0 版本被移除了，但是在7.1 版本又加上了。

使用 PHP 7.0 的用户，可以降级到 PHP 5 或升级到 PHP 7.1，或者用 Docker。

## 安装 ##

Phabricator 需要 3 个仓库的代码：arcanist、libphutil、phabricator。其中phabricator是项目的主体，arcanist 是 Phabricator 的命令行工具，libphutil 是Phabricator 的实用工具集，包括文件系统、markdown解析、守护进程等。

假设 `webroot` 目录为 `/var/www` ，则执行如下命令：

cd /var/www
    mkdir phabricator && cd $_
    git clone https://github.com/phacility/libphutil.git
    git clone https://github.com/phacility/arcanist.git
    git clone https://github.com/phacility/phabricator.git

保证 arcanist、libphutil、phabricator 目录为并列关系。

root@localhost:/var/www/phabricator# ls
    arcanist  libphutil  phabricator

配置 nginx：

其中 root 指向 phabricator 目录的 webroot。

server {
      server_name phabricator.example.com;
      root        /var/www/phabricator/phabricator/webroot;
    
      location / {
        index index.php;
        rewrite ^/(.*)$ /index.php?__path__=/$1 last;
      }
    
      location /index.php {
        fastcgi_pass   localhost:9000;
        fastcgi_index   index.php;
    
        #required if PHP was built with --enable-force-cgi-redirect
        fastcgi_param  REDIRECT_STATUS    200;
    
        #variables to make the $_SERVER populate in PHP
        fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
        fastcgi_param  QUERY_STRING       $query_string;
        fastcgi_param  REQUEST_METHOD     $request_method;
        fastcgi_param  CONTENT_TYPE       $content_type;
        fastcgi_param  CONTENT_LENGTH     $content_length;
    
        fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
    
        fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
        fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;
    
        fastcgi_param  REMOTE_ADDR        $remote_addr;
      }
    }

## 配置 ##

## 数据库 ##

首先要设置用于 Phabricator 连接的数据库配置。

cd /var/www/phabricator/phabricator
    phabricator/ $ ./bin/config set mysql.host localhost
    phabricator/ $ ./bin/config set mysql.user root
    phabricator/ $ ./bin/config set mysql.pass 123456

然后执行：

phabricator/ $ ./bin/storage upgrade

## 邮件 ##

Phabricator 支持的 [邮件系统][Link 3] 很多，如Mailgun、Amazon SES、SendGrid、SMTP。这里以 SMTP 为例。

有两种方式配置邮件发送。

### 1. 配置文件 ###

修改 conf/local/local.json ，加入如下配置：

{
      "phpmailer.smtp-protocol": "SSL",
      "phpmailer.smtp-password": "密码",
      "phpmailer.smtp-user": "邮箱地址",
      "phpmailer.smtp-port": 端口号,
      "phpmailer.smtp-host": "邮件服务器"
    }

### 2. 命令行 ###

用 bin/config 命令进行设置，如：

phabricator/ $ ./bin/config set phpmailer.smtp-protocol ssl
    phabricator/ $ phabricator/ $ ./bin/config set phpmailer.smtp-password 密码
    phabricator/ $ ./bin/config set phpmailer.smtp-user 邮箱地址
    phabricator/ $ ./bin/config set phpmailer.smtp-port 端口号
    phabricator/ $ ./bin/config set phpmailer.smtp-host 邮件服务器

### 验证 ###

配置完成后，可以用命令行测试邮件发送配置是否正确：

phabricator/ $ ./bin/mail list-outbound   # 列出所有邮件
    phabricator/ $ ./bin/mail show-outbound   # 显示某条邮件
    phabricator/ $ ./bin/mail send-test       # 发送测试邮件

例如给 david 发送 主题为 hello 的邮件，正文在 body.txt 里：

phabricator/ $ ./bin/mail send-test --to david --subject 'hello' < ./body.txt
    Reading message body from stdin...
    Mail sent! You can view details by running this command:
    
        phabricator/ $ ./bin/mail show-outbound --id 37773

执行 `./bin/mail show-outbound --id 37773` 可以看到此处发送的调试信息。

PROPERTIES
    ID: 37773
    Status: sent
    Related PHID:
    Message:
    
    PARAMETERS
    sensitive: 1
    cc: []
    subject: hello
    is-bulk:
    mailtags: []
    ...............

这些命令对调试邮件配置和开发新的邮件适配器 (Adapter) 很有用处。

\#结语

至此，Phabricator 可以使用了。更详细的功能和配置请参考 [Phabricator User Documentation][]

[Phabricator]: https://www.colabug.com/goto/aHR0cHM6Ly9waGFjaWxpdHkuY29tL3BoYWJyaWNhdG9yLw==
[3cb125c9507f2890336d77ddbb6f335c.png]: https://img.colabug.com/2017/10/3cb125c9507f2890336d77ddbb6f335c.png
[Link 1]: https://www.colabug.com/tag/shu-ju-ku/
[install_ubuntu.sh]: https://www.colabug.com/goto/aHR0cHM6Ly9zZWN1cmUucGhhYnJpY2F0b3IuY29tL3NvdXJjZS9waGFicmljYXRvci9icm93c2UvbWFzdGVyL3NjcmlwdHMvaW5zdGFsbC9pbnN0YWxsX3VidW50dS5zaA==
[PHP]: https://www.colabug.com/tag/php/
[Link 2]: https://www.colabug.com/goto/aHR0cHM6Ly9zZWN1cmUucGhhYnJpY2F0b3IuY29tL1QxMjEwMQ==
[Link 3]: https://www.colabug.com/goto/aHR0cHM6Ly9zZWN1cmUucGhhYnJpY2F0b3IuY29tL2Jvb2svcGhhYnJpY2F0b3IvYXJ0aWNsZS9jb25maWd1cmluZ19vdXRib3VuZF9lbWFpbC8=
[Phabricator User Documentation]: https://www.colabug.com/goto/aHR0cHM6Ly9zZWN1cmUucGhhYnJpY2F0b3IuY29tL2Jvb2svcGhhYnJpY2F0b3Iv