本手册描述了 Subversion 1.6.x 系列。如果您运行的是其他版本的 Subversion,强烈建议您访问 https://svnbook.subversion.org.cn/ 并查阅适合您的 Subversion 版本的手册。
mod_dav_svn 配置指令 - 通过 Apache HTTP 服务器提供 Subversion 仓库的 Apache 配置指令。
以下是在 httpd.conf
中适用于 mod_dav_svn 的指令。
DAV svn
必须包含在任何用于 Subversion 仓库的 Directory
或 Location
块中。它告诉 httpd 使用 Subversion 后端,以便 mod_dav
处理所有请求。
SVNActivitiesDB directory-path
指定活动数据库应存储在文件系统中的位置。默认情况下,mod_dav_svn 在名为 dav/activities.d
的仓库中创建并使用一个目录。使用此选项指定的路径必须是绝对路径。
如果为 SVNParentPath
区域指定,mod_dav_svn 会将仓库的基名附加到此处指定的路径。例如
<Location /svn> DAV svn # any "/svn/foo" URL will map to a repository in # /net/svn.nfs/repositories/foo SVNParentPath "/net/svn.nfs/repositories" # any "/svn/foo" URL will map to an activities db in # /var/db/svn/activities/foo SVNActivitiesDB "/var/db/svn/activities" </Location>
SVNAllowBulkUpdates On|Off
切换对更新样式的 REPORT
请求的全包响应的支持。Subversion 客户端使用 REPORT
请求从 mod_dav_svn 获取有关目录树检出和更新的信息。它们可以要求服务器以两种方式之一发送该信息:使用树信息在单个大型响应中发送,或者使用 skelta(树增量的骨架表示),它只包含足够的信息让客户端知道要从服务器请求哪些 其他 数据。当此指令包含值为 Off
时,mod_dav_svn 将只对这些 REPORT
请求使用 skelta 响应,无论客户端请求的响应类型如何。
大多数人根本不需要使用此指令。它主要用于希望(出于安全或审计原因)强制 Subversion 客户端单独获取更新和检出所需的所有文件和目录的管理员,从而在 Apache 日志中留下 GET
和 PROPFIND
请求的审计跟踪。此指令的默认值为 On
。
SVNAutoversioning On|Off
当其值为 On
时,允许 WebDAV 客户端的写入请求导致自动提交。自动生成一个通用日志消息并将其附加到每个修订版。如果启用自动版本控制,您可能需要设置 ModMimeUsePathInfo On
,以便 mod_mime
可以自动将 svn:mime-type
设置为正确的 MIME 类型(当然,只要 mod_mime
能够做到这一点)。有关更多信息,请参见 附录 C,WebDAV 和自动版本控制。此指令的默认值为 Off
。
SVNIndexXSLT directory-path
指定用于目录索引的 XSL 变换的 URI。此指令是可选的。
SVNListParentPath On|Off
设置为 On
时,允许对 SVNParentPath
进行 GET
操作,这将导致列出该路径下所有仓库。默认设置为 Off
。
SVNMasterURI url
指定主 Subversion 仓库的 URI(用于直通代理)。
SVNParentPath directory-path
指定父目录在文件系统中的位置,其子目录是 Subversion 仓库。在 Subversion 仓库的配置块中,必须存在此指令或 SVNPath
,但不能同时存在。
SVNPath directory-path
指定 Subversion 仓库文件在文件系统中的位置。在 Subversion 仓库的配置块中,必须存在此指令或 SVNParentPath
,但不能同时存在。
SVNPathAuthz On|Off|short_circuit
通过启用子请求 (On
)、禁用子请求 (Off
;参见 “禁用基于路径的检查”部分) 或直接查询 mod_authz_svn (short_circuit
) 来控制基于路径的授权。此指令的默认值为 On
。
SVNReposName name
指定 Subversion 仓库的名称,用于 HTTP GET
响应。此值将附加到所有目录列表的标题中(当您使用 Web 浏览器导航到 Subversion 仓库时,这些列表将显示)。此指令是可选的。
SVNSpecialURI component
指定特殊 Subversion 资源的 URI 组件(命名空间)。默认值为 !svn
,大多数管理员永远不会使用此指令。仅在迫切需要在仓库中拥有名为 !svn
的文件时才设置此值。如果您在正在使用的服务器上更改此值,它将破坏所有未完成的工作副本,您的用户会拿着干草叉和火把追捕您。