From c4237370f34c282c80b507d3755b0fec6546f033 Mon Sep 17 00:00:00 2001 From: Nextcloud bot Date: Thu, 11 Jul 2024 02:50:54 +0000 Subject: [PATCH] generate documentation from config.sample.php --- .../config_sample_php_parameters.rst | 36 +++++++++++++------ 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 77824108a..f6e8f0027 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -2851,39 +2851,55 @@ restricted. Defaults to the value of `datadirectory` if unset. If set, the value MUST be located _outside_ of the installation directory of Nextcloud and writable by the Web server user. -blacklisted_files -^^^^^^^^^^^^^^^^^ +forbidden_filenames +^^^^^^^^^^^^^^^^^^^ :: - 'blacklisted_files' => ['.htaccess'], + 'forbidden_filenames' => ['.htaccess'], -Blacklist a specific file or files and disallow the upload of files +Block a specific file or files and disallow the upload of files with this name. ``.htaccess`` is blocked by default. WARNING: USE THIS ONLY IF YOU KNOW WHAT YOU ARE DOING. +Note that this list is case-insensitive. + Defaults to ``array('.htaccess')`` -forbidden_chars -^^^^^^^^^^^^^^^ +forbidden_filename_characters +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: - 'forbidden_chars' => [], + 'forbidden_filename_characters' => [], -Blacklist characters from being used in filenames. This is useful if you +Block characters from being used in filenames. This is useful if you have a filesystem or OS which does not support certain characters like windows. -The '/' and '\' characters are always forbidden. +The '/' and '\' characters are always forbidden, as well as all characters in the ASCII range [0-31]. -Example for windows systems: ``array('?', '<', '>', ':', '*', '|', '"', chr(0), "\n", "\r")`` +Example for windows systems: ``array('?', '<', '>', ':', '*', '|', '"')`` see https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits Defaults to ``array()`` +forbidden_filename_extensions +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +:: + + 'forbidden_filename_extensions' => ['.part', '.filepart'], + +Deny extensions from being used for filenames. + +The '.part' extension is always forbidden, as this is used internally by Nextcloud. + +Defaults to ``array('.filepart', '.part')`` + theme ^^^^^