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
FancyIndexingF=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/p_w_picpath.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/p_w_picpath.xbm) p_w_picpath/*
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