App Config Reference

The app config is located at app/config/app.php. These options control core application functionality.
compile_container
Control whether or not the container is compiled.
There is no corresponding configuration option for this value in theapp/config definitions because this option is applied before the application container (and configuration) is loaded.
Possible Values
Default Value
Environment Variable
false or <unset>
<unset>
COMPILE_CONTAINER
dark_mode
Enable dark mode.
Removed with the introduction of the user-facing theme toggle in v3.7.0
Possible Values
Default Value
Environment Variable
true or false
false
DARK_MODE
date_format
The format used for rendering dates in the application views.
Possible Values
Default Value
Environment Variable
See the PHP date format documentation for possible values.
Y-m-d H:i:s
DATE_FORMAT
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.
Possible Values
Default Value
Environment Variable
true or false
false
APP_DEBUG
display_readmes
Parse and render README files on the page.
Possible Values
Default Value
Environment Variable
true or false
true
DISPLAY_READMES
google_analytics_id
Your Google analytics tracking ID.
Possible Values
Default Value
Environment Variable
A string in the format of UA-123456789-0 or false to disable
false
GOOGLE_ANALYTICS_ID
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.
Possible Values
Default Value
Environment Variable
A path (string) to a file
.hidden
HIDDEN_FILES_LIST
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.
Possible Values
Default Value
Example
An array of paths (strings)
[] (an empty array)
1
'hidden_files' => [
2
    'somefile.txt', // Matches 'somefile.txt' exactly
3
    'README.*', // Matches files named 'README' with any file extension
4
    'foo/*', // Matches all files in the 'foo' directory
5
    'schema.{ya?ml}', // Matches 'schema.yml' or 'schema.yaml'
6
]
Copied!
hide_app_files
Hide application specific files/directories (i.e. index.php and the app folder).
Possible Values
Default Value
Environment Variable
true or false
true
HIDE_APP_FILES
hide_dot_files
Hide dot files/directories from the listing.
Possible Values
Default Value
Environment Variable
true or false
true
HIDE_DOT_FILES
hide_vcs_files
Hide the files Version Control Systems (i.e. Git and Mercurial) use to store their metadata.
Possible Values
Default Value
Environment Variable
true or false
true
HIDE_VCS_FILES
home_text
Text of the home link in the navigation breadcrumbs. If undefined or null will use the translated form of "home" form your selected language.
Possible Values
Default Value
Environment Variable
Any string
null
HOME_TEXT
language
The application's interface language.
Possible Values
Default Value
Environment Variable
See the app/translations folder for available translations.
en (English)
APP_LANGUAGE
matomo_analytics_site_id
Your Matomo analytics site ID.
Possible Values
Default Value
Environment Variable
A Matomo analytics site ID (string)
false
MATOMO_ANALYTICS_SITE_ID
matomo_analytics_url
Your Matomo analytics URL.
Possible Values
Default Value
Environment Variable
A Matomo analytics URL (string)
false
MATOMO_ANALYTICS_URL
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.
Possible Values
Default Value
Environment Variable
Any positive integer 0 - 9223372036854775807 (PHP_INT_MAX)
1000000000 (1 GB)
MAX_HASH_SIZE
meta_description
Meta tag description (i.e. <meta name="description">) text.
Possible Values
Default Value
Environment Variable
Any string
Yet another directory listing, powered by Directory Lister.
META_DESCRIPTION
readmes_first
Show READMEs before the file listing.
Possible Values
Default Value
Environment Variable
true or false
false
READMES_FIRST
reverse_sort
When enabled, reverses the order of files (after sorting is applied).
Possible Values
Default Value
Environment Variable
true or false
false
REVERSE_SORT
site_title
The title of your directory listing. This will be displayed in the browser tab/title bar along with the current path.
Possible Values
Default Value
Environment Variable
Any string
Directory Lister
SITE_TITLE
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
1
'sort_order' => \DI\value(
2
    function (SplFileInfo $file1, SplFileInfo $file2) {
3
        return strcmp($file1->getRealPath(), $file2->getRealPath());
4
    })
5
);
Copied!
Possible Values
Default Value
Environment Variable
type, natural, name, accessed, changed, modified, <anonymous function>
type
SORT_ORDER
timezone
Timezone used for data formatting.
Possible Values
Default Value
Environment Variable
For a list of supported timezones see: https://www.php.net/manual/en/timezones.php.
The server's timezone
TIMEZONE
zip_downloads
Enable downloading of directories as a zip archive.
Possible Values
Default Value
Environment Variable
true or false
true
ZIP_DOWNLOADS

Configuration - Previous

Configuration Overview

Next - Configuration

Cache Config Reference

Last modified 2mo ago

`compile_container`

`dark_mode`

`date_format`

`debug`

`display_readmes`

`google_analytics_id`

`hidden_files_list`

`hidden_files`

`hide_app_files`

hide_dot_files

`hide_vcs_files`

`home_text`

`language`

`matomo_analytics_site_id`

`matomo_analytics_url`

`max_hash_size`

`meta_description`

`readmes_first`

`reverse_sort`

`site_title`

`sort_order`

Example

`timezone`

`zip_downloads`