首页 > 代码库 > apache mod_autoindex 详解

apache mod_autoindex 详解




mod_autoindex的作用是生成目录索引,类似于unix的ls命令,或者是win32的dir命令 当从服务器请求一个目录的时候,可能来自:

  • mod_dir的DirectoryIndex指定首页

  • mod_autoindex列目录

这两个模块都是相互独立的,如有需要可以放心的删除、替换。 mod_autoindex模块的指令有:AddAlt,AddAltByEncoding,AddAltByType,AddDescription,AddIcon,AddIconByEncoding, AddIconByType,DefaultIcon,HeaderName,IndexHeadInsert,IndexIgnore,IndexOptions, IndexOrderDefault,IndexStyleSheet,ReadmeName

IndexOptions指令

IndexOptions指令的FancyIndexing选项可以让列表头部增加可以让列表按Name,Last modified,Size,Description排序的链接,如图:  默认情况是上图,打开IndexOptions FancyIndexing之后出现了Name,Last modified,Size,Description,点击可以让列表按参数从新排序,参数的定义如下:

  • C=N 根据文件名排序

  • C=M 根据最后修改时间,然后根据文件名排序

  • C=S 根据文件大小排序,然后根据文件名排序

  • C=D 根据描述排序,然后根据文件名排序

  • O=A 正序排列

  • O=D 反序排列

  • F=0 列表简单格式化(没有使用FancyIndexing样式)

  • F=1 FancyIndexing

  • F=2 HTMLTable FancyIndexing组合样式

  • V=0 VersionSort 关闭

  • V=1 VersionSort 打开

  • P=pattern 搜索符合pattern的文件列表

注意 P搜索符合pattern的文件列表是在IndexIgnore指令处理之,参数只能是以上列表范围以内的,其他任意的参数都将让mod_autoindex模块继续执行。 如果不需要头部的排序链接,可以使用IndexOptions SuppressColumnSorting IndexOptions指令用户目录索引的各种配置设置,设置有:

  • Charset=character-set (Apache 2.0.61 and later)

  • Charset关键字用于设定页面的字符集,默认的字符集是ISO-8859-1或者UTF-8,取决于文件系统是否是unicode。这个最好不要修改,我测试了一下修改为GB2312,firefox,ie就乱码了

  • Type=MIME content-type (Apache 2.0.61 and later)

  • Type关键字用于指定MIME内容类型,默认是text/html,如果你蛋疼的修改为text/plain也是可以的,只是显示出来的页面都是html代码

    IndexOptions Type=text/plain
  • DescriptionWidth=[n | *] (Apache 2.0.23 and later)

  • DescriptionWidth用于定义描述列的宽度,单位是字符,-DescriptionWidth可以自动计算出最佳宽度,DescriptionWidth=n 指定宽度为n个字符,DescriptionWidth=* 满足最长的描述字符串,当然默认的情况下是没有描述的,需要使用AddDescription指令添加描述。类似的还有NameWidth,

  • FancyIndexing

  • 打开fancy indexing(花式索引),打开后除了文件名,也列出了文件大小,最后修改时间,描述。

  • SuppressDescription

  • 在FancyIndexing的情况下禁用描述的显示

  • SuppressLastModified

  • 在FancyIndexing的情况下禁用最后修改时间的显示

  • SuppressLastModified

  • 在FancyIndexing的情况下禁用最后修改时间的显示

  • SuppressIcon

  • 在FancyIndexing的情况下禁用图标的显示

  • SuppressRules (Apache 2.0.23 and later)

  • 去掉hr水平线

  • SuppressColumnSorting

  • 在FancyIndexing的情况下去掉头部的排序链接,如果需要忽略这些参数,请使用IgnoreClient。

  • FoldersFirst (Apache 2.0.23 and later)

  • 让目录排在文件前面,只有FancyIndexing启动的时候才起作用

  • HTMLTable (Experimental, Apache 2.0.23 and later)

  • 以表格的方式展示列表,实验性的功能

  • IconsAreLinks

  • 让图标也成为可点击链接的一部分

  • IconHeight[=pixels]和IconWidth[=pixels]

  • 通过让img标签增加width和height属性设定文件(夹)图标高度和宽度,默认大小是图标的大小

  • IgnoreCase

  • 排列不区分大小写

  • IgnoreClient

  • 让排序参数无效,

  • SuppressHTMLPreamble

  • 暂时没有理解

  • TrackModified (Apache 2.0.23 and later)

  • 让http头返回Last-Modified和Etag信息,OS2的JFS和Win32的NTFS文件系统支持,而OS2和FAT则不支持。部分操作系统如unix平台只跟踪新建和删除的文件,文件的大小和日期的改变则不会被跟踪。

  • VersionSort (Apache 2.0a3 and later)

  • 版本号排序发,比如:

    foo-1.7foo-1.7.2foo-1.7.12foo-1.8.2foo-1.8.2afoo-1.12

    如果没有VersionSort ,那foo-1.12应该是排在第一个

  • XHTML (Apache 2.0.49 and later)

  • 让列表文档的html3.2源代码变成xhtml源代码

从apache 1.3.3版本开始IndexOptions支持多个指令组合在一起,比如:

IndexOptions HTMLTableIndexOptions SuppressColumnsorting

IndexOptions HTMLTable SuppressColumnsorting

是一个意思 所有的指令都可以带“+”和“-”符号,表示对父目录设置的基础上进行增加和删除,如果没有“+”和“-”符号前缀的设置则表示之前继承的设置前全新清空,重新设置。

AddAlt指令

AddAlt将指定文件名的图标替换为文本 语法是: AddAlt string file [file] … [file]可以是文件扩展名,文件名部分,通配符(wild-card)表达式,或者文件全名,string file是替换成的字符串,如果字符串有空格,需使用单引号或双引号包裹起来(” or ‘ ),当指定了图标(比如通过AddIcon),但是图标资源无法找到或者用户在加载网页的时候提前停止,这种情况下就用字符串替换图标,字符串内容放在alt标签,比如:alt=”字符串”,目录的默认字符串是[DIR],文件默认是[ ]。 例子:

AddAlt "我有 空格" *.pdfAddAlt 我没有空格 *.gz *.zip *.Z

AddAltByEncoding指令

和AddAlt一样,只是方法是通过指定MIME编码(MIME-encoding) 例子:

AddAltByEncoding "我是gzip文件,嘎嘎~~" x-gzip

AddAltByType指令

和AddAlt一样,只是方法是通过指定MIME内容类型(MIME content-type) 例子:

AddAltByType ‘plain text‘ text/plain

AddDescription指令

给文件(夹)添加描述,如果描述有空格,使用双引号包裹起来 例子:

AddDescription "The planet Mars" /web/pics/mars.gif

AddIcon指令

语法:AddIcon icon name [name] … 指定文件名来添加图标,图标url可以是一个%转移后的 相对地址,绝对url,或这样的格式:(alttext,url),其中alttext是非图形浏览器的替换文本。其中的name,^^DIRECTORY^^表示所有目录,^^BLANKICON^^是空白行,一个文件扩展名,通配符表达式,一个部分或全文件名。如果使用IndexOptions HTMLTable,那么^^BLANKICON^^是没有用了,因为他是用来格式化的,HTMLTable已经格式化好了。如果可能AddIconByType应该优先于(in preference to..)AddIcon使用 例子:

AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbmAddIcon /icons/dir.xbm ^^DIRECTORY^^AddIcon /icons/backup.xbm *~AddIcon /icons/binary.gif .bin .exeAddIcon /icons/binhex.gif .hqxAddIcon /icons/tar.gif .tarAddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .ivAddIcon /icons/compressed.gif .Z .z .tgz .gz .zipAddIcon /icons/a.gif .ps .ai .epsAddIcon /icons/layout.gif .html .shtml .htm .pdfAddIcon /icons/text.gif .txtAddIcon /icons/c.gif .cAddIcon /icons/p.gif .pl .pyAddIcon /icons/f.gif .forAddIcon /icons/dvi.gif .dviAddIcon /icons/uuencoded.gif .uuAddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tclAddIcon /icons/tex.gif .texAddIcon /icons/bomb.gif coreAddIcon /icons/back.gif ..AddIcon /icons/hand.right.gif READMEAddIcon /icons/folder.gif ^^DIRECTORY^^AddIcon /icons/blank.gif ^^BLANKICON^^

AddIconByEncoding指令

和AddIcon一样,只是通过MIME编码来区分文件 例子:

AddIconByEncoding /icons/compress.xbm x-compress

AddIconByType指令

和AddIcon一样,只是通过MIME内容类型来区分文件 例子:

AddIconByType (IMG,/icons/image.xbm) image/*

DefaultIcon指令

没有通过AddIcon*指定的文件图标的指定 例子:

DefaultIcon /icon/unknown.xbm

HeaderName指令

语法:HeaderName filename 在列表的开头插入指定html文件,ReadmeName和HeaderName一样把filename当作相对于当前目录的URI处理,如果以“/”开头,则是相对于DocumentRoot目录。

HeaderName HEADER.html
HeaderName /include/HEADER.html

IndexHeadInsert指令

语法:IndexHeadInsert “markup …” 在列表页面的<head>标签内插入html代码,

IndexHeadInsert ""

IndexIgnore指令

IndexIgnore让指定file排除在显示列表之外,也就是忽略显示,也就是不显示,file可以是文件全名,或是shell样式的通配符。 默认是 IndexIgnore “.” 也就是忽略当前目录 语法:IndexIgnore file [file] …

IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t

IndexOrderDefault指令

IndexOrderDefault用于设定目录排序 语法:IndexOrderDefault Ascending|Descending Name|Date|Size|Description 默认:IndexOrderDefault Ascending Name IndexOrderDefault必须在FancyIndexing启动的时候起作用,默认FancyIndexing是按文件名正序排序,IndexOrderDefault可以用来改变默认的排序方式。

ReadmeName指令

和HeaderName功能一样,只是插入的位置是尾部,而不是头部。

ReadmeName FOOTER.html

ReadmeName /include/FOOTER.html


本文出自 “坚持就是胜利” 博客,请务必保留此出处http://lilinji.blog.51cto.com/5441000/1431719