SVN-鉤子祥解

鉤子腳本的具體寫法就是操做系統中shell腳本程序的寫法,請根據本身SVN所在的操做系統和shell程序進行相應的寫做


所謂鉤子就是與一些版本庫事件觸發的程序，例如新修訂版本的建立，或是未版本化屬性的修改。每一個鉤子都會被告滿足夠多的信息，包括那是什麼事件，所操做的對象，和觸發事件的用戶名。經過鉤子的輸出或返回狀態，鉤子程序能讓工做繼續、中止或是以某種方式掛起。

默認狀況下，鉤子的子目錄中包含各類版本庫鉤子模板。

$ ls repos/hooks/
post-commit.tmpl          pre-revprop-change.tmpl
post-revprop-change.tmpl start-commit.tmpl
pre-commit.tmpl          

對每種Subversion版本庫支持的鉤子的都有一個模板，經過查看這些腳本的內容，你能看到是什麼事件觸發了腳本及如何給傳腳本傳遞數據。同時，這些模版也是如何使用這些腳本，結合Subversion支持的工具來完成有用任務的例子。要實際安裝一個可用的鉤子，你須要在 repos/hooks目錄下安裝一些與鉤子同名（如 start-commit或者post-commit）的可執行程序或腳本。


提示
因爲安全緣由，Subversion版本庫在一個空環境中執行鉤子腳本—就是沒有任何環境變量，甚至沒有$PATH或%PATH%。因爲這個緣由，許多管理員會感到很困惑，它們的鉤子腳本手工運行時正常，可在Subversion中卻不能運行。要注意，必須在你的鉤子中設置好環境變量或爲你的程序指定好絕對路徑。

目前Subversion有已實現了五種鉤子：

start-commit.bat
它在提交事務產生前已運行，一般用來斷定一個用戶是否有權提交。版本庫傳給該程序兩個參數：到版本庫的路徑，和要進行提交的用戶名。若是程序返回一個非零值，會在事務產生前中止該提交操做。若是鉤子程序要在stderr中寫入數據，它將排隊送至客戶端。

pre-commit.bat
在事務完成提交以前運行，一般這個鉤子是用來保護由於內容或位置（例如，你要求全部到一個特定分支的提交必須包括一個bug追蹤的ticket號，或者是要求日誌信息不爲空）而不容許的提交。版本庫傳遞兩個參數到程序：版本庫的路徑和正在提交的事務名稱，若是程序返回非零值，提交會失敗，事務也會刪除。若是鉤子程序在stderr中寫入了數據，也會傳遞到客戶端。

Subversion的分發版本包括了一些訪問控制腳本（在Subversion源文件目錄樹的tools/hook-scripts目錄），能夠用來被pre-commit調用來實現精密的寫訪問控制。另外一個選擇是使用Apache的httpd模塊mod_authz_svn，能夠對單個目錄進行讀寫訪問控制（見「每目錄訪問控制」一節）。在將來的Subversion版本中,咱們計劃直接在文件系統中實現訪問控制列表（ACL）。

post-commit.bat
它在事務完成後運行，建立一個新的修訂版本。大多數人用這個鉤子來發送關於提交的描述性電子郵件，或者做爲版本庫的備份。版本庫傳給程序兩個參數：到版本庫的路徑和被建立的新的修訂版本號。退出程序會被忽略。

Subversion分發版本中包括mailer.py和commit-email.pl腳本（存於Subversion源代碼樹中的 tools/hook-scripts/目錄中）能夠用來發送描述給定提交的email（而且或只是追加到一個日誌文件），這個mail包含變化的路徑清單，提交的日誌信息、日期和做者以及修改文件的GNU區別樣式輸出。

Subversion提供的另外一個有用的工具是hot-backup.py腳本（在Subversion源代碼樹中的tools/backup/目錄中）。這個腳本能夠爲Subversion版本庫進行熱備份（Berkeley DB數據庫後端支持的一種特性），能夠製做版本庫每次提交的快照做爲歸檔和緊急狀況的備份。

pre-revprop-change.bat
由於Subversion的修訂版本屬性不是版本化的，對這類屬性的修改（例如提交日誌屬性 svn:log）將會永久覆蓋之前的屬性值。由於數據在此可能丟失，因此Subversion提供了這種鉤子（及與之對應的post-revprop- change），所以版本庫管理員可用一些外部方法記錄變化。做爲對丟失未版本化屬性數據的防範，Subversion客戶端不能遠程修改修訂版本屬性，除非爲你的版本庫實現這個鉤子。

這個鉤子在對版本庫進行這種修改時纔會運行，版本庫給鉤子傳遞四個參數：到版本庫的路徑，要修改屬性的修訂版本，通過認證的用戶名和屬性自身的名字。

post-revprop-change.bat
咱們在前面提到過，這個鉤子與pre-revprop-change對應。事實上，由於多疑的緣由，只有存在pre-revprop-change時這個腳本纔會執行。當這兩個鉤子都存在時，post-revprop-change在修訂版本屬性被改變以後運行，一般用來發送包含新屬性的email。版本庫傳遞四個參數給該鉤子：到版本庫的路徑，屬性存在的修訂版本，通過校驗的產生變化的用戶名，和屬性自身的名字。

Subversion分發版本中包含propchange-email.pl腳本（在Subversion源代碼樹中的tools/hook- scripts/目錄中），能夠用來發送修訂版本屬性修改細節的email（而且或只是追加到一個日誌文件）。這個email包含修訂版本和發生變化的屬性名，做出修改的用戶和新屬性值。

警告

不要嘗試用鉤子腳本修改事務。一個常見的例子就是在提交時自動設置svn:eol-style或svn:mime-type這類屬性。這看起來是個好主意，但它會引發問題。主要的問題是客戶並不知道由鉤子腳本進行的修改，同時沒有辦法通告客戶它的數據是過期的，這種矛盾會致使出人意料和不能預測的行爲。

做爲嘗試修改事務的替代，咱們經過檢查pre-commit鉤子的事務，在不知足要求時拒絕提交。
Subversion會試圖以當前訪問版本庫的用戶身份執行鉤子。一般，對版本庫的訪問老是經過Apache HTTP服務器和mod_dav_svn進行，所以，執行鉤子的用戶就是運行Apache的用戶。鉤子自己須要具備操做系統級的訪問許可，用戶能夠運行它。另外，其它被鉤子直接或間接使用的文件或程序（包括Subversion版本庫自己）也要被同一個用戶訪問。換句話說，要注意潛在的訪問控制問題，它可能會讓你的鉤子沒法按照你的目的順利執行
原文：http://hi.baidu.com/gacmotor/blog/item/da499e2b4f65fa25d42af192.html