Configuration Reference
Bootstrap Configuration
These configuration options are special configuration options only configurable through environment variables (e.g. through the .env
file).
There are no corresponding configuration options for these values in the app/config
definitions because they are applied before the application container (and configuration) is loaded.
FILES_PATH
FILES_PATH
A path (relative or absolute) to the directory in which you would like to list. This may even be a path outside of the application directory. When left unset, the root application directory (i.e. the folder where index.php
is located) will be listed.
An absolute or relative file path (string)
COMPILE_CONTAINER
COMPILE_CONTAINER
Whether or not the application container will be compiled. When set to false
the container will not be compiled and cached. If left unset the container will be compiled and cached on first run and the cached container will be reused on subsequent requests. Disabling this comes with a (likely negligible) performance hit. Generally this should not be changed but might be necessary to modify when running Directory Lister on a read-only filesystem.
false
or <unset>
Runtime Configuration
General runtime configuration is controlled by the app config located at app/config/app.php
. These options control core application functionality.
It is highly recommended to set these values via their respective environment variables. This can be accomplished via a .env
file located in the root of your application. An example file is provided as .env.example
.
analytics_file
analytics_file
File containing analytics scripts that will be included in the HTML output of your directory listing.
A (string) file name
date_format
date_format
The format used for rendering dates in the application views.
See the PHP date
format documentation for possible values.
debug
debug
Enable application debugging and display error messages.
It is recommended that debug remains OFF unless troubleshooting an issue. Leaving this enabled WILL cause leakage of sensitive server information.
true
or false
display_readmes
display_readmes
Parse and render README
files on the page.
true
or false
google_analytics_id
google_analytics_id
Your Google analytics tracking ID.
This configuration option has been deprecated and will stop working in a future release. See the Analytics Script Injection section for instructions on configuring analytics tracking.
A string in the format of UA-123456789-0
or false
to disable
hidden_files_list
hidden_files_list
File containing hidden file definitions. Will be merged with definitions from the 'hidden_files' configuration option.
See the Hiding Files page for additional info on hiding files.
A path (string) to a file
hidden_files
hidden_files
Array of hidden file definitions. Will be merged with definitions in the file defined in the hidden_files_list
configuration option. Supports glob patterns (e.g. *.txt
, file.{yml,yaml}
, etc.).
See the Hiding Files page for additional info on hiding files.
An array of paths (strings)
hide_app_files
hide_app_files
Hide application specific files/directories (i.e. index.php
and the app
folder).
true
or false
hide_dot_files
hide_dot_files
Hide dot files/directories from the listing.
true
or false
hide_vcs_files
hide_vcs_files
Hide the files Version Control Systems (i.e. Git and Mercurial) use to store their metadata.
true
or false
home_text
home_text
Text of the home
link in the navigation breadcrumbs. If undefined or null
will use the translated form of "home" from your selected language.
Any string
language
language
The application's interface language.
See the app/translations
folder for available translations.
matomo_analytics_site_id
matomo_analytics_site_id
Your Matomo analytics site ID.
This configuration option has been deprecated and will stop working in a future release. See the Analytics Script Injection section for instructions on configuring analytics tracking.
A Matomo analytics site ID (string)
matomo_analytics_url
matomo_analytics_url
Your Matomo analytics URL.
This configuration option has been deprecated and will stop working in a future release. See the Analytics Script Injection section for instructions on configuring analytics tracking.
A Matomo analytics URL (string)
max_hash_size
max_hash_size
The maximum file size (in bytes) that can be hashed. This helps to prevent timeouts for excessively large files.
The larger a file is the longer it will take to calculate hashes for that file.
Any positive integer 0
- 9223372036854775807
(PHP_INT_MAX
)
meta_description
meta_description
Meta tag description (i.e. <meta name="description">
) text.
Any string
readmes_first
readmes_first
Show READMEs before the file listing.
true
or false
reverse_sort
reverse_sort
When enabled, reverses the order of files (after sorting is applied).
true
or false
site_title
site_title
The title of your directory listing. This will be displayed in the browser tab/title bar along with the current path.
Any string
sort_order
sort_order
Sorting order of files and folders. Can be one of several predefined values or a custom anonymous function.
When using an anonymous function it must be wrapped in a \DI\value()
function. The anonymous function receives two \SplFileInfo
objects as arguments and expects an integer to be returned.
Example
type
, natural
, name
, accessed
, changed
, modified
, <anonymous function>
timezone
timezone
Time zone used for date formatting.
For a list of supported time zones see: https://www.php.net/manual/en/timezones.php.
zip_downloads
zip_downloads
Enable downloading of directories as a zip archive.
true
or false
zip_compress
zip_compress
Compress Zip using Deflate. Enabling this option prevents file size estimation and it may prevent zip download resuming when paused.
true
or false
Cache Configuration
The cache config is located at app/config/cache.php
. These options control the application cache.
It is highly recommended to set these values via their respective environment variables. This can be accomplished via a .env
file located in the root of your application. An example file is provided as .env.example
.
cache_driver
cache_driver
The application cache driver. Setting this value to array
will disable the cache across requests. Additional driver-specific options may be required with certain values.
apcu
, array
, file
, memcached
, redis
, php-file
cache_lifetime
cache_lifetime
The app cache lifetime (in seconds). Setting this value to 0
will cache indefinitely.
Any positive integer
cache_lottery
cache_lottery
Some cache drivers require manually pruning the cache periodically to remove expired items. This is the percentage chance (out of 100) of a request "winning" the lottery causing the cache to be pruned.
Any integer betweeen 1
and 100
memcached_host
memcached_host
The Memcached server hostname or IP address.
Any string
memcached_port
memcached_port
The Memcached server port.
Any valid port as an integer (0
to 65353
)
memcached_config
memcached_config
The Memcached configuration anonymous function (closure). This option is used when the cache_driver
configuration option is set to memcached
. The closure receives a Memcached
object as it's only parameter. You can use this object to configure the Memcached connection. At a minimum you must connect to one or more Memcached servers via the addServer()
or addServers()
methods.
Reference the PHP Memcached documentation for Memcached configuration options.
An anonymous function that receives a Memcached
object
redis_host
redis_host
The Redis server hostname or IP address.
Any string
redis_port
redis_port
The Redis server port.
Any valid port as an integer (0
to 65353
)
redis_config
redis_config
The Redis configuration anonymous function (closure). This option is used when the cache_driver
configuration option is set to redis
. The closure receives a Redis
object as it's only parameter. You can use this object to configure the Redis connection. At a minimum you must connect to one or more Redis servers via the connect()
or pconnect()
methods.
Reference the phpredis documentation for Redis configuration options.
An anonymous function that receives a Redis
object
http_cache
http_cache
HTTP cache values for controlling browser page cache durations. An array of mimetypes mapped to their cache duration in seconds..
An array of mime types mapped to their cache duration as a seconds (integers).
view_cache
view_cache
Path to the view cache directory. Set to false
to disable view caching entirely.
A directory path as a string or false
to disable the view cache entirely
Icon Configuration
The icon config is located at app/config/icons.php
. Here is were file types are mapped to their respective icons. The mapping is a PHP array where the array key is the file extension (without a preceding dot) and the array value is the desired Font Awesome class names.
Last updated
Was this helpful?