# Install Phabricator and run on the Gitlab
最近跑的專案都是四個人以上同時開發，有時候程式碼被改了，Pull 下來改完衝突，發現程式碼都會錯亂。排除每個人對 Git 熟練度，我覺得 Gitlab 對於 Review code 做的似乎不是很友善。[Scrum](http://zh.wikipedia.org/wiki/Scrum)在跑的時候碰到這類型的問題，每次要解決都要花不少時間。
在某一次尋找 Git 相關教學的時候發現了一個蠻冷門的東西[Phabricator](http://phabricator.org/)，當初看到這套的時候第一印象就覺得這也是版本控制，所以加入最愛後就沒再理他，當碰到最近的問題，才想到我似乎在哪裡有看到這種問題的 Solution。
這一套 Phabricator 是 Facebook 釋出的 Open Source，Facebook 也是為了解決 Code Review, Track Bugs, Browse Source...等等這些問題才會開發這一套系統。
### 開始安裝
在官網是很詳細的安裝方式我在這邊粗略的介紹一下。
要使用 Phabricator 一定得先安裝 git, apache, mysql, php, php extensions (mbstring, iconv...等)
* git (usually called "git" in package management systems)
* Apache (usually "httpd" or "apache2") (or nginx)
* MySQL Server (usually "mysqld" or "mysql-server")
* PHP (usually "php")
* Required PHP extensions: mbstring, iconv, mysql (or mysqli), curl, pcntl (these might be something like "php-mysql" or "php5-mysql")
* Optional PHP extensions: gd, apc (special instructions for APC are available below if you have difficulty installing it), xhprof (instructions below, you only need this if you are developing Phabricator)
他還有些版本的限制，必需要注意。安裝以上是比較基本的，接下來就是 clone。
```bash
$ cd somewhere/ # pick some install directory
somewhere/ $ git clone git://github.com/facebook/libphutil.git
somewhere/ $ git clone git://github.com/facebook/arcanist.git
somewhere/ $ git clone git://github.com/facebook/phabricator.git
```
clone 下來最好就在 libphutil、arcanist、phabricator 先執行`git pull`因為我沒有這樣做，多花了一個小時找問題阿...結果根本就不是最新的版本。
另外可以選擇是不是要安裝 APC、XHProf
### 修改 httpd-vhosts.conf
我的東西大部份都是部屬在 Apache 上這個也不例外。所以我加上 sub domain 相關的參數。
```bash
vim /etc/httpd/conf.d/httpd-vhosts.conf
```
```
# Change this to the domain which points to your host.
ServerName phabricator.example.com.tw
# Change this to the path where you put 'phabricator' when you checked it
# out from GitHub when following the Installation Guide.
#
# Make sure you include "/webroot" at the end!
DocumentRoot /path/to/phabricator/webroot
RewriteEngine on
RewriteRule ^/rsrc/(.*) - [L,QSA]
RewriteRule ^/favicon.ico - [L,QSA]
RewriteRule ^(.*)$ /index.php?__path__=$1 [B,L,QSA]
Order allow,deny
Allow from all
```
設定完 domain 訪問設定的網址，依照指示要先設定 Mysql。
### 設定 Mysql
```bash
$ cd /somewhere/phabricator/
$ ./bin/config set mysql.host mysql主機
Set 'mysql.host' in local configuration.
$ ./bin/config set mysql.user mysql帳號
Set 'mysql.user' in local configuration.
$ ./bin/config set mysql.pass mysql密碼
Set 'mysql.pass' in local configuration.
```
### Phabricator upgrade
更新到最新的版本會有下列訊息。
```bash
./bin/storage upgrade
Before running storage upgrades, you should take down the Phabricator web
interface and stop any running Phabricator daemons (you can disable this
warning with --force).
Are you ready to continue? [y/N] y
Loading quickstart template...
Applying patch 'phabricator:db.conpherence'...
Applying patch 'phabricator:db.token'...
Applying patch 'phabricator:db.releeph'...
Applying patch 'phabricator:db.phlux'...
Applying patch 'phabricator:db.phortune'...
Applying patch 'phabricator:db.phrequent'...
Applying patch 'phabricator:db.diviner'...
...
...
Done.
Storage is up to date. Use 'storage status' for details.
```
更新完畢後再回去網頁，會看到登入畫面。
### 設定 Admin 帳號
```bash
./bin/accountadmin
Enter a username to create a new account or edit an existing account.
Enter a username: admin
There is no existing user account 'admin'.
Do you want to create a new 'admin' account? [Y/n] Y
Enter user real name: admin
Enter user email address: xxx@xxxx
Enter a password for this user [blank to leave unchanged]:
Should this user be a system agent? [y/N] y
Should this user be an administrator? [y/N] y
ACCOUNT SUMMARY
OLD VALUE NEW VALUE
Username admin
Real Name admin
Email xxx@xxxx
Password Updated
System Agent N Y
Admin N Y
Save these changes? [Y/n] y
Saved changes.
```
最後就是需要開啟背景執行。
```bash
./bin/config set phabricator.base-uri 'http://phabricator.example.com.tw/'
Set 'phabricator.base-uri' in local configuration.
```
```bash
./bin/phd start
Staging launch...
NOTE: Logs will appear in '/var/tmp/phd/log/daemons.log'.
Launching 'PhabricatorRepositoryPullLocalDaemon'...
Launching 'PhabricatorGarbageCollectorDaemon'...
Launching 'PhabricatorTaskmasterDaemon'...
Launching 'PhabricatorTaskmasterDaemon'...
Launching 'PhabricatorTaskmasterDaemon'...
Launching 'PhabricatorTaskmasterDaemon'...
Done.
```
這樣就完成了，我覺得他的安裝非常簡單。安裝下來我也沒遇到什麼大問題。
### 與 Gitlab 串接
登入後在左邊的選單依序點選
ADMINISTRATION > Repositories > Create New Repository
表單中填入
Name: yout project name
Callsign: VCS
Type: Git
> Callsign 為什麼是 VCS 因為[這邊](http://www.phabricator.com/docs/phabricator/article/Diffusion_User_Guide.html)有相關的設定可以參考。
>
> It is followed by the repository callsign, and then a VCS-specific commit identifier (for SVN, the commit number; for Git and Mercurial, the commit hash)。
下一步後依序設定：
**Basics**
Tracking: Enabled
**Remote URI**
Repository URI: your repository url
**Repository Information**
Local Path: your project path
Track Only: your want track branches
設定完就可以看到
點選 View in Diffusion 可以看到這個 repository 的各種記錄
若在某一次的記錄 review code 發現有問題都可以在 diffusion > Raise Concern，回報都會有紀錄存在直到消除 Raise Concern。
> Sep 14th, 2013 11:09:00am
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://alanmoment.gitbook.io/moment/xie_zuo_gong_ju/install_phabricator_and_run_on_the_gitlab.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.