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

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

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

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

如果操作系统为 ubuntu ，希望快速安装，可以拷贝 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。

据 官方声明 ，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 支持的 邮件系统 很多，如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) 很有用处。