搭配Phabricator客户端

一、概述

1. 官方链接

(1)Git下载
(2)PHP下载
(3)Arcanist项目地址
(4)Arcanist快速安装

2. 基本介绍

要参与Phabricator的工作流,就必须使用Arcanist工具,该工具运行在PHP环境上,负责用户终端与Phabricator服务端的交互。

注:如果使用较早的版本,arcanist还依赖项目libphutil

3. 环境说明

本文以win10系统为例,使用命令行和界面的方式进行操作说明,命令行打开快捷操作:Win + R输入cmdEnter

二、安装

1. 安装Git

(1)下载安装

官网下载windows版,具体版本无要求,选择安装路径后一路Next即可。

安装完成后使用命令git --version查看是否安装完全。

(2)配置信息

这部分可选,主要是用来标识git用户信息,命令如下:

# 设置用户名
C:\Users\You> git config --global user.name  "yourname"

# 设置用户邮箱
C:\Users\You> git config --global user.email "yourname@mailbox"

# 查看所有配置
C:\Users\You> git config --list 

2. 安装PHP

先使用命令php -v查看是否已安装完全。

(1)下载PHP

官网windows版下载。

版本建议>=7.1的线程安全版,根据自己的OS架构选择x64还是x86版。

确定具体版本后可以看到三个选项,下载Zip压缩包。

(2)解压配置PHP

使用压缩工具将下载好的zip包解压到你想安装的目录,如D:\Application\PHP\

进入PHP的根目录(含文件php.exe的目录),同时可以看到文件php.ini-development,在该目录下复制这个文件为php.ini

php.ini文件中去掉如下几行内容的注释,即行前的分号;,没有对应配置可忽略:

  • extension_dir="ext"
  • extension=php_curl.dll
  • extension=php_mbstring.dll
(3)设置环境变量

Win + R输入sysdm.cpl打开系统属性窗口,选择高级标签页,进入环境变量设置界面。

选择当前用户或系统全局的Path变量,添加一条变量记录,即上述PHP根目录路径,确定后退出。

重启cmd,使用php -v查看安装是否生效。

3. 安装Arcanist

(1)使用Git下载项目

git下载项目方便后期升级,但速度较慢,你也可以使用第二步的方法。

# 选择安装目录
C:\Users\You> D:
D:\> cd Application\Arcanist\

# clone项目
D:\Application\Arcanist> git clone https://github.com/phacility/arcanist.git
(2)直接下载压缩包

如果没有使用Git克隆项目,在这里下载项目的压缩包,同PHP一样解压到对应的安装目录。

(3)设置环境变量

同PHP环境变量的添加,将arcanist根目录下bin文件夹的路径添加到Path环境变量里,该文件夹下含有arc.bat文件。

重启cmd后,输入命令arc help查看配置是否生效。

(4)自定义arc配置

这部分以后补充。。。

三、配置

1. 配置SSH

要能够访问服务端的代码仓库,本机需要配置SSH信息。

# 生成ssh密钥对,这个过程需要输入路径和密码,一般直接Enter跳过,代表默认路径和密码为空
C:\Users\You> ssh-keygen -t rsa -C "yourname@mailbox"

生成的公私钥在用户目录C:\Users\You\.ssh文件夹下,密钥文件id_rsa和公钥文件id_rsa.pub

将公钥文件的内容放到Phabricator服务端,在Settings > SSH Public Keys里上传即可。

2. 权限认证

(1)给arc提供Phabricator服务端信息
# 设置服务端地址
C:\Users\You> arc set-config default http://phabricator.company.site/

# 查看已有配置
C:\Users\You> arc get-config

# 安装证书,按照提示访问地址并把凭据复制过来
C:\Users\You> arc install-certificate
(2)设置arc输入的文本编辑器
# 设置编辑器.exe启动文件的路径,如使用Git自带的vim:Git安装目录\usr\bin\vim.exe
C:\Users\You> arc set-config editor "/PATH"

四、总结

1. 主要参考博客

(1)phabricator客户端使用(windows)

2. 下一步

接下来你应该了解Phabricator的工作流Workflow,以及如何使用arc来操作。

上一篇:使用docker镜像搭建phabricator


下一篇:Git + Phabricator日常的使用方法