一、概述
1. 官方链接
(1)Git下载
(2)PHP下载
(3)Arcanist项目地址
(4)Arcanist快速安装
2. 基本介绍
要参与Phabricator
的工作流,就必须使用Arcanist
工具,该工具运行在PHP
环境上,负责用户终端与Phabricator服务端的交互。
注:如果使用较早的版本,arcanist还依赖项目libphutil
3. 环境说明
本文以win10系统为例,使用命令行和界面的方式进行操作说明,命令行打开快捷操作:Win + R
输入cmd
后Enter
。
二、安装
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
来操作。