apache mod_autoindex 详解

cfsky

　　


　　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排序的链接，如图： http://tunps.com/wp-content/uploads/2011/03/mod_autoindex_with_fancyindexing_disable.pnghttp://tunps.com/wp-content/uploads/2011/03/mod_autoindex_with_fancyindexing_enable.png 默认情况是上图，打开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的情况下禁用图标的显示
  

• 　　Suppre***ules (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 *.ZAddAltByEncoding指令
　　和AddAlt一样，只是方法是通过指定MIME编码（MIME-encoding） 例子：
AddAltByEncoding "我是gzip文件，嘎嘎～～" x-gzipAddAltByType指令
　　和AddAlt一样，只是方法是通过指定MIME内容类型（MIME content-type） 例子：
AddAltByType 'plain text' text/plainAddDescription指令
　　给文件（夹）添加描述，如果描述有空格，使用双引号包裹起来 例子：
AddDescription "The planet Mars" /web/pics/mars.gifAddIcon指令
　　语法：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-compressAddIconByType指令
　　和AddIcon一样，只是通过MIME内容类型来区分文件 例子：
AddIconByType (IMG,/icons/image.xbm) image/*DefaultIcon指令
　　没有通过AddIcon*指定的文件图标的指定 例子：
DefaultIcon /icon/unknown.xbmHeaderName指令
　　语法：HeaderName filename 在列表的开头插入指定html文件，ReadmeName和HeaderName一样把filename当作相对于当前目录的URI处理，如果以“/”开头，则是相对于DocumentRoot目录。
HeaderName HEADER.htmlHeaderName /include/HEADER.htmlIndexHeadInsert指令
　　语法：IndexHeadInsert “markup …” 在列表页面的标签内插入html代码，
IndexHeadInsert ""IndexIgnore指令
　　IndexIgnore让指定file排除在显示列表之外，也就是忽略显示，也就是不显示，file可以是文件全名，或是shell样式的通配符。 默认是 IndexIgnore “.” 也就是忽略当前目录 语法：IndexIgnore file [file] …
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,tIndexOrderDefault指令
　　IndexOrderDefault用于设定目录排序 语法：IndexOrderDefault Ascending|Descending Name|Date|Size|Description 默认：IndexOrderDefault Ascending Name IndexOrderDefault必须在FancyIndexing启动的时候起作用，默认FancyIndexing是按文件名正序排序，IndexOrderDefault可以用来改变默认的排序方式。
ReadmeName指令
　　和HeaderName功能一样，只是插入的位置是尾部，而不是头部。
ReadmeName FOOTER.html　　ReadmeName /include/FOOTER.html