說明：svn集成功能配置會比較復(fù)雜，我們會盡量通過文檔來幫助大家配置成功！如果實在配置不成功的，可以考慮找我們做收費技術(shù)支持。

禪道于2.2版本內(nèi)置了svn集成功能，把禪道和用戶代碼進行有效關(guān)聯(lián)，方便用戶查看。這篇文章將給大家講述如何配置禪道集成svn。 

一、subversion集成機制說明

subversion集成的基本機制是：分析提交代碼時的注釋 => 得出相應(yīng)的story, task, bugID => 寫入到禪道的數(shù)據(jù)庫。

實現(xiàn)上述功能有兩個方案，一個方案是采用svn自帶的鉤子機制，當(dāng)有代碼提交的時候，觸發(fā)一個鉤子腳本，然后分析注釋，得出相應(yīng)的bug, story或者task的id號，然后調(diào)用禪道的api，將相關(guān)的記錄寫入數(shù)據(jù)庫。還有一個方案是通過svn客戶端軟件的log命令，來獲得所有的提交記錄，然后分析，得出相應(yīng)的id，寫入數(shù)據(jù)庫。

上述兩個方案各有各自的優(yōu)缺點，我們最終是選擇了第二個方案。因為第二個方案調(diào)試比較好調(diào)試，部署也相對方便，同時可以解析之前的所有記錄，有比較好的靈活性。

二、在禪道所在機器上面部署svn命令行客戶端。

svn命令行客戶端是指subversion自帶的svn命令。windows下面是svn.exe，linux下面是沒有后綴的svn。

禪道所在的機器可以和subversion機器分開，不在一臺機器上面。

1. 如果是linux機器，需要安裝svn的客戶端。rhel,centos可以用yum安裝subversion, debian下面可以用apt-get install。
2. 如果最新下載的windows一鍵安裝包2.2版本，里面已經(jīng)內(nèi)置了svn.exe的客戶端。
3. 如果是之前版本的一鍵安裝包，可以下載上文所說的svn客戶端包。解壓縮到zentao的目錄。在usr/local/下面可以找到silksvn就對了。
4. 如果在windows下面自己安裝，可以考慮下載silksvn的客戶端軟件，安裝。 

三、配置禪道關(guān)于subversion的參數(shù)

3.1 代碼位置

    1、一鍵安裝包：zentao/home/zentao/module/svn/config.php

    2、源碼包：zentao包位置/module/svn/config.php

注意，您可以直接修改上述的config.php文件，但建議您將改動保存到svn/ext/config/svn.php中。這樣將來我們升級，就不會覆蓋您的配置文件。

3.2 配置內(nèi)容

關(guān)于subversion參數(shù)的設(shè)置，一共有下面幾個概念：

1. svn客戶端命令的位置。
2. 庫(repo): 可以配置多個庫。
3.  庫的用戶名和參數(shù)。

下面讓我們用實際的例子來說明。

3.2.1 如下圖，找到圖中紅框標(biāo)志的位置

3.2.2 修改代碼

寫法如下面例子所示

 $config->svn->client 這個是用來存儲svn客戶端執(zhí)行文件svn.exe路徑的，源碼包用戶需自行下載svn客戶端（也可下載svn包，解壓后 upgrade\usr\local 目錄下 silksvn 文件夾為svn客戶端，將其部署到禪道所在環(huán)境中）(一件安裝包不需要設(shè)置此項)；

 $config->svn->repos[$i]['path']  這個是用來存儲svn代碼路徑的；

 $config->svn->repos[$i]['username'] 這個是用來存儲svn登錄用戶名的； 如果不需要登錄，可以保持為空。

 $config->svn->repos[$i]['password'] 這個是用來存儲svn登錄密碼的。  

3.3 配置多個庫

3.3.1 同上，在同一個文件里找到如下代碼

3.3.2 修改代碼

 ①將代碼中的“/*”和”*/“刪除，其余修改同上，注意：$i ++ 不可修改。

 ②如果還有svn庫，復(fù)制此段代碼，進行同樣的配置即可。 

四、代碼提交注釋格式：

開發(fā)者在提交svn的時候，需要在備注里面注明此次修改相關(guān)的需求，或者任務(wù)，或者bug的id。比如下面的格式：

bug#123,234, 1234，也可以是bug:123,234 1234，id列表之間，用逗號和空格都可以。

story#123 task#123

bug, story, task是必須標(biāo)注的。:) 

五、執(zhí)行svn同步命令 

5.1 通用的執(zhí)行方式

5.1.1 打開命令行，進入zentao目錄的bin目錄。windows的一鍵安裝包是在home/zentao/bin目錄下面 。

5.1.2 執(zhí)行php ztcli http://禪道的訪問路徑/svn-run.html 或者 ?m=svn&f=run  這里面的訪問路徑根據(jù)實際的進行修改。比如：

php ztcli http://pms.zentao.net/svn-run.html  PATH_INFO方式。
php ztcli http://pms.zentao.net/?m=svn&f=run GET方式。

這其中的php，需要換成php或者php.exe所在的路徑。

關(guān)于ztcli的使用，可以看我們的文檔。

5.2 一鍵安裝包 

windows一鍵安裝包版本我們做了一些方便的修改，可以在bin目錄下面，直接執(zhí)行syncsvn.bat命令即可。(2.2版本內(nèi)置，之前的一鍵安裝包需要下載我們的svn客戶端包) 

5.3  程序運行的效果圖:

5.4 查看相應(yīng)的bug:

六、部署定時任務(wù)

上述命令部署好之后，將該命令加入定時任務(wù)就好了。比如可以5分鐘執(zhí)行一次。

windows下面使用計劃任務(wù)，linux下面使用crontab。

主要注意的是，在部署計劃任務(wù)的時候，svn同步命令需要在bin目錄下面。因此需要先cd到bin所在的目錄。比如

cd c:/zentao/home/zentao/bin; syncsvn.bat

cd /home/www/zentao/bin; php ztcli http://xxxx/svn-run.html