mirror/php-ifm
1
0
Fork 0
mirror of https://github.com/misterunknown/ifm.git synced 2025-08-16 21:13:59 +02:00
Code Issues Releases Wiki Activity

Updated Configuration (markdown)

Marco Dickert
2020-01-13 17:27:01 +01:00
parent 518d894772
commit 481ad99008
1 changed files with 2 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
Configuration.md

@@ -26,7 +26,9 @@ The IFM offers the following configuration options. The names depend on wheather
| :-------- | :------- | :---------- |
| `auth`, `auth_source` | IFM_AUTH, IFM_AUTH_SOURCE | see [authentication](https://github.com/misterunknown/ifm/wiki/Authentication) |
| `root_dir` | IFM_ROOT_DIR | Sets a custom root directory. By default the IFM is locked to its own directory, so you can't go above. Notice that the PHP user has to have sufficient permissions for the `root_dir`, otherwise IFM will not work. Regardless of whether the `root_dir` is set or not, the IFM will **not follow symlinks**, as long as the destination lies outside the `root_dir`. This is by design and cannot be changed. |
| `root_public_url` | IFM_ROOT_PUBLIC_URL | If you set a custom `root_dir`, the IFM cannot be sure if it is publicly available. Therefore it has a "proxy" API, which allows you to get the files anyway. However, if you don't want that, e.g. because you want to share links with people who are not allowed to access the IFM, and there **is** a way to publicly request these files, you can set a custom URL. This can be either relative (if it starts with a slash), or absolute (if it starts with `http`). So, if you set the `root_public_url` to `/www`, the IFM builds the link with `window.location.origin`, your custom `root_public_url` part and the actual file (http://example.org/www/actual_file). If the first character is not a slash, IFM treats the URL as absolute, and simply adds the actual file name (http://other_subdomain.example.org/actual_file).
| `tmp_dir` | IFM_TMP_DIR | Sets a custom temporary directory. This is used to save temporary zip files when you download an entire directory. Make sure the PHP user has write permissions there. |
| `timezone` | IFM_TIMEZONE | Sets a custom timezone (for supported timezones see [this page](https://www.php.net/manual/de/timezones.php)). |
| `ajaxrequest` | IFM_API_AJAXREQUEST | Controls if the user is allowed to perform an ajax request. This was primarily used to debug the IFM in the development process and I didn't remove it since it's quite useful in some cases. |
| `chmod` | IFM_API_CHMOD | Controls if the user is allowed to change permissions of files and directories. |
| `copymove` | IFM_API_COPYMOVE | Controls if the user is allowed to copy or move files and directories. |