MAC上配置code review

对于团队开发来说，code review环节能够令成员间互相学习，代码通过磨合形成规范，是一种较好的开发模式。

目前常用的code review工具很多，在此不一一列举，各有特色。现介绍一种Facebook开源（好像现在不属于Facebook的了）的工具Phabricator及其配置。

 Phabricator具有很多功能，code review、bug管理等。不过我所在项目主要是用code review功能。

在Mac上配置Phabricator不是很复杂，也不需要翻墙，国内的网络目前也能够快速响应。

首先你需要用版本管理工具管理项目代码，如git，svn。这里以svn为例。

第二你需要有Apache，Mac已经自带Apache了。

第三你需要有PHP，Mac又已经帮忙准备好了！

第四你需要MySQL，这个你需要自己下载安装。http://dev.mysql.com/downloads/，下载Community Server、WorkBlench（界面）

接着，找到存放文件的目录somewhere，在somewhere目录下运行命令：

git clone git://github.com/facebook/libphutil.git

git clone git://github.com/facebook/arcanist.git

git clone git://github.com/facebook/phabricator.git

把需要到的软件下载完毕后，配置Apache服务器。

修改 /etc/apache2/httpd.conf，加载php5_module和rewrite_module，默认前面有＃，把＃去掉

把Include /private/etc/apache2/extra/httpd-vhosts.conf前的＃去掉，因为要配置虚拟主机。

修改/etc/apache2/extra/httpd-vhosts.conf，配置如下：

Listen 8085
<Directory "/Users/RyoHo/phabricator-master/webroot">
  Require all granted
</Directory>
<VirtualHost *:8085>
    DocumentRoot "/Users/RyoHo/phabricator-master/webroot"
    RewriteEngine on
    RewriteRule ^/rsrc/(.*)     -                       [L,QSA]
    RewriteRule ^/favicon.ico   -                       [L,QSA]
    RewriteRule ^(.*)$          /index.php?__path__=$1  [B,L,QSA]
</VirtualHost>

Listen 8085、VirtualHost *:8085：监听端口，可以改成其他，只要不跟在用的端口冲突一般都没问题

DocumentRoot：虚拟主机的路径，把phabricator下的webroot路径设置进去

设置完毕后，开启或重启Apache服务器

这个时候已经设置了一大半。登陆http://127.0.0.1:8085仍没有正常显示，原因一般为Phabricator需要升级和数据库没有设置好。按提示设置就好。

成功设置完毕后，打开地址将出现管理员注册界面，按提示注册即可。

如果需要增加用户可以在phabricator目录下用命令 ./bin/accountadmin 设置。网页也可以增加用户，但管理员无法设置用户密码，只能用户自行邮件设置。（邮件功能需要另外设置）

phabricator可以当作是一个code review的界面，实际上触发把差异代码发送到phabricator的是arcanist。

现在我把客户端arcanist的设置步骤简单说说：

客户端设置步骤：
1、从git上clone arcanist，libphutil属于支持模块，一并clone（服务器步骤已经做过，如果服务端和客户端不同这步需要做）
$ mkdir somewhere/
$ cd somewhere/
somewhere/ $ git clone git://github.com/facebook/libphutil.git
somewhere/ $ git clone git://github.com/facebook/arcanist.git


2、将arc脚本路径加入PATH环境变量中
cd进入个人目录,在个人的.bash_profile文件中加入 export PATH="$PATH:/somewhere/arcanist/bin/",
保存后在命令行执行 sourse ./bash_profile


3、如果你是项目负责人，则项目需要新建.arcconfig文件，文件内容如下：

{
  "project.name" : "项目名",
  "phabricator.uri" : 服务器phabricator地址
}

4、安装Arcanist证书
然后 cd yourproject/
输入 arc install-certificate

按提示操作。

设置完毕。



arcanist简单使用步骤：
1、在项目目录中输入 arc diff --create
在提交文件中填写title，reviewer，test plan ，按提示保存
2、登陆Phabricator服务器，点击右上角主页图标后，如果有review任务，则在Differential处出现提示。点击进去可以看到待审批的任务，再点击进去可以看到代码差异明细，根据需要选择Action（如果没有问题accept，如果需要修改则request changes）