Embedthis Appweb 3.4.0
Home > Users Guide > Configuration Directives > Directory Directives

Quick Nav

See Also

Directory Directives

Directory

Description Define a block of directives to apply to a directory tree
Synopsis <Directory directoryPath>
...
</Directory
Context Default server, Virtual host
Example <Directory "/var/www/acme">
    AuthType Digest
    AuthName "Acme Inc."
    Require valid-user
</Directory>
Notes

The Directory directive defines a block of directives that apply to the named directory and all sub-directories and files. The directoryPath is the full path to the directory. Unlike Apache, it may not contain wildcards.

Inside the directory block, you may use any directive that supports a Directory context. You may not nest Directory directives inside other Directory blocks. But you may use Directory blocks inside VirtualHost blocks.

The difference between the Directory and Location directives is that while the Directory directive applies to files in the file system, the Location directive applies to the URLs before they are mapped to file names.

DirectoryIndex

Description Define the default index file to serve for directory requests
Synopsis DirectoryIndex document
Context Default Server, Virtual host, Directory
Example DirectoryIndex index.php
Notes

The DirectoryIndex directive specifies the document that will be served when a HTTP request is made for the index of a directory. A browser requests a directory index by issuing a request with a trailing "/" in the URL.

For example: if a DirectoryIndex of "index.php" is specified and a user requestes http://www.acme.com/products/. Then the document /products/index.php will be returned to the user.

NOTE: Unlike Apache, only one document may be specified in the DirectoryIndex directive. Also, only one DirectoryIndex directive may appear per context.

IndexOptions

Description Define directory indexing options
Synopsis IndexOptions [[+|-] options] ...
Context Default server, Virtual host, Directory
Example IndexOptions FancyIndexing
Notes

The available options are:

  • FancyIndexing — Enable fancy indexing
  • FoldersFirst — List folders first
  • HtmlTable — Display listings in a HTML table

IndexOrder

Description Set the default ordering of the directory listing
Synopsis IndexOrder [Ascending|Descending] [Name|Date|Size|Description]
Context Default server, Virtual host, Directory
Example IndexOrder Ascending Name
Notes

This directive controls the order of listings. By default, listings are displayed in filename ascending order. This directive only applies if IndexOptions is set to display listings in fancy format.

© Embedthis Software LLC, 2003-2012. All rights reserved. Embedthis, Ejscript and Appweb are trademarks of Embedthis Software LLC.