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