<?php
/**
- * @copyright Copyright (C) 2010-2022, the Friendica project
+ * @copyright Copyright (C) 2010-2023, the Friendica project
*
* @license GNU AGPL version 3 or any later version
*
'port' => null,
// socket (String)
- // Socket of the database server.
- // Can be used instead of adding a socket location to the hostname
- 'socket' => '',
+ // Socket of the database server.
+ // Can be used instead of adding a socket location to the hostname
+ 'socket' => '',
// user (String)
- // Database user name. Please don't use "root".
+ // Database username. Please don't use "root".
'username' => '',
// pass (String)
'pdo_emulate_prepares' => true,
// disable_pdo (Boolean)
- // PDO is used by default (if available). Otherwise MySQLi will be used.
+ // PDO is used by default (if available). Otherwise, MySQLi will be used.
'disable_pdo' => false,
// persistent (Boolean)
'always_show_preview' => false,
// ap_always_bcc (Boolean)
- // Adresses non-mentioned ActivityPub receivers by BCC instead of CC. Increases privacy, decreases performance.
+ // Addresses non-mentioned ActivityPub receivers by BCC instead of CC. Increases privacy, decreases performance.
'ap_always_bcc' => false,
// archival_days (Integer)
// The value has to start with the scheme and end with a "/"
'avatar_cache_url' => '',
+ // basicauth (Boolean)
+ // Controls if login via BasicAuth is possible (default is true)
+ 'basicauth' => true,
+
// big_emojis (Boolean)
// Display "Emoji Only" posts in big.
'big_emojis' => false,
'block_local_dir' => false,
// blocked_tags (String)
- // Comma separated list of hash tags that shouldn't be displayed in the trending tags
+ // Comma separated list of hashtags that shouldn't be displayed in the trending tags
'blocked_tags' => '',
// community_no_sharer (Boolean)
'community_no_sharer' => false,
// contact_update_limit (Integer)
- // How much contacts should be checked at a time?
+ // How many contacts should be checked at a time?
'contact_update_limit' => 100,
// cron_interval (Integer)
// Whether to use Memcache, Memcached, Redis or APCu to store temporary cache.
'cache_driver' => 'database',
+ // decoupled_receiver (Boolean)
+ // Decouple incoming AP posts by doing the processing in the background.
+ 'decoupled_receiver' => false,
+
// distributed_cache_driver (database|memcache|memcached|redis)
// Whether to use database, Memcache, Memcached or Redis as a distributed cache.
'distributed_cache_driver' => 'database',
+ // fetch_parents (Boolean)
+ // Fetch missing parent posts
+ 'fetch_parents' => true,
+
// config_adapter (jit|preload)
// Allow to switch the configuration adapter to improve performances at the cost of memory consumption.
'config_adapter' => 'jit',
// Periodically delete waiting database processes.
'delete_sleeping_processes' => false,
+ // delete-blocked-servers (Boolean)
+ // Delete blocked servers if there are no foreign key violations.
+ 'delete-blocked-servers' => false,
+
// dice_profiler_threshold (Float)
// For profiling Dice class creation (0 = disabled, >0 = seconds threshold for profiling)
'dice_profiler_threshold' => 0.5,
'disable_implicit_mentions' => false,
// disable_url_validation (Boolean)
- // Disables the DNS lookup of an URL.
+ // Disables the DNS lookup of a URL.
'disable_url_validation' => false,
// disable_password_exposed (Boolean)
// restricts develop log writes to requests originating from this IP address.
'dlogip' => '',
+ // emoji_activities (Boolean)
+ // Display received activities (like, dislike, reshare) as emojis
+ 'emoji_activities' => false,
+
// expire-notify-priority (integer)
- // Priority for the expirary notification
- 'expire-notify-priority' => PRIORITY_LOW,
+ // Priority for the expiry notification
+ 'expire-notify-priority' => Friendica\Core\Worker::PRIORITY_LOW,
+
+ // fetch_by_worker (Boolean)
+ // Fetch missing posts via a background process
+ 'fetch_by_worker' => false,
+
+ // fetch_featured_posts (Boolean)
+ // Fetch featured posts from all contacts
+ 'fetch_featured_posts' => false,
// free_crawls (Integer)
// Number of "free" searches when system => permit_crawling is enabled.
// groupedit_image_limit (Integer)
// Number of contacts at which the group editor should switch from display the profile pictures of the contacts to only display the names.
- // This can alternatively be set on a per account basis in the pconfig table.
+ // This can alternatively be set on a per-account basis in the pconfig table.
'groupedit_image_limit' => 400,
// gserver_update_limit (Integer)
- // How much servers should be checked at a time?
+ // How many servers should be checked at a time?
'gserver_update_limit' => 100,
// hsts (Boolean)
'ipv4_resolve' => false,
// invitation_only (Boolean)
- // If set true registration is only possible after a current member of the node has send an invitation.
+ // If set true registration is only possible after a current member of the node has sent an invitation.
'invitation_only' => false,
// itemspage_network (Integer)
'itemspage_network_mobile' => 20,
// jpeg_quality (Integer)
- //
+ //
// Lower numbers save space at cost of image detail
// where n is between 1 and 100, and with very poor results below about 50
'jpeg_quality' => 100,
// If activated, all hashtags will point to the local server.
'local_tags' => false,
+ // lock_driver (semaphore|database|memcache|memcached|redis|apcu)
+ // Whether to use semaphores, the database, Memcache, Memcached, Redis or APCu to handle locks.
+ // Default is auto detection which tries semaphores first, then falls back to the cache driver.
+ 'lock_driver' => '',
+
// logger_config (String)
// Sets the logging adapter of Friendica globally (monolog, syslog, stream)
'logger_config' => 'stream',
// max_image_length (Integer)
// An alternate way of limiting picture upload sizes.
- // Specify the maximum pixel length that pictures are allowed to be (for non-square pictures, it will apply to the longest side).
+ // Specify the maximum pixel length that pictures are allowed to be (for non-square pictures, it will apply to the longest side).
// Pictures longer than this length will be resized to be this length (on the longest side, the other side will be scaled appropriately).
// If you don't want to set a maximum length, set to -1.
'max_image_length' => -1,
// max_likers (Integer)
- // Maximum number of "people who like (or don't like) this" that we will list by name
+ // Maximum number of "people who like (or don't like) this" that we will list by name
'max_likers' => 75,
// max_processes_backend (Integer)
// Maximum number of concurrent database processes for foreground tasks.
'max_processes_frontend' => 20,
+ // max_recursion_depth (Integer)
+ // Maximum recursion depth when fetching posts until the job is delegated to a worker task or finished.
+ 'max_recursion_depth' => 50,
+
// maximagesize (Integer)
// Maximum size in bytes of an uploaded photo.
'maximagesize' => 800000,
'no_oembed' => false,
// no_redirect_list (Array)
- // List of domains where HTTP redirects should be ignored.
+ // List of domains where HTTP redirects should be ignored.
'no_redirect_list' => [],
// no_smilies (Boolean)
// Don't show smilies.
'no_smilies' => false,
+ // optimize_all_tables (Boolean)
+ // Optimizes all tables instead of only tables like workerqueue or the cache
+ 'optimize_all_tables' => false,
+
// paranoia (Boolean)
// Log out users if their IP address changed.
'paranoia' => false,
// permit_crawling (Boolean)
- // Restricts the search for not logged in users to one search per minute.
+ // Restricts the search for not logged-in users to one search per minute.
'permit_crawling' => false,
// pidfile (Path)
'pidfile' => '',
// png_quality (Integer)
- // Sets the ImageMagick compression level for PNG images. Values ranges from 0 (uncompressed) to 9 (most compressed).
+ // Sets the ImageMagick compression level for PNG images. Values range from 0 (uncompressed) to 9 (most compressed).
'png_quality' => 8,
+ // process_view (Boolean)
+ // Process the "View" activity that is used by Peertube. View activities are displayed, when "emoji_activities" are enabled.
+ 'process_view' => false,
+
// profiler (Boolean)
// Enable internal timings to help optimize code. Needed for "rendertime" addon.
'profiler' => false,
// pushpoll_frequency (Integer)
- // Frequency of contact poll for subhub contact using the DFRM or OStatus network.
+ // Frequency of contact poll for subhub contact using the DFRN or OStatus network.
// Available values:
// - 5 = every month
// - 4 = every week
// The authentication password for the redis database
'redis_password' => null,
+ // redistribute_activities (Boolean)
+ // Redistribute incoming activities via ActivityPub
+ 'redistribute_activities' => true,
+
+ // relay_deny_languages (Array)
+ // Array of languages (two digit format) that are rejected.
+ 'relay_deny_languages' => [],
+
+ // relay_deny_undetected_language (Boolean)
+ // Deny undetected languages
+ 'relay_deny_undetected_language' => false,
+
// session_handler (database|cache|native)
// Whether to use Cache to store session data or to use PHP native session storage.
'session_handler' => 'database',
// runtime_loglimit (Integer)
// The runtime is logged, When the program execution time is higher than this value.
'runtime_loglimit' => 0,
-
+
// sendmail_params (Boolean)
// Normal sendmail command parameters will be added when the PHP mail() function is called for sending e-mails.
// This ensures the Sender Email address setting is applied to the message envelope rather than the host's default address.
'set_creation_date' => false,
// show_global_community_hint (Boolean)
- // When the global community page is enabled, use this option to display a hint above the stream, that this is a collection of all public top-level postings that arrive on your node.
+ // When the global community page is enabled, use this option to display a hint above the stream, that this is a collection of all public top-level postings that arrive at your node.
'show_global_community_hint' => false,
// show_received (Boolean)
- // Show the receive data along with the post creation date
+ // Show the received date along with the post creation date
'show_received' => true,
// show_received_seconds (Integer)
// username_min_length (Integer)
// The minimum character length a username can be.
- // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
+ // This length is checked once the username has been trimmed and multiple spaces have been collapsed into one.
// Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
'username_min_length' => 3,
// username_max_length (Integer)
// The maximum character length a username can be.
- // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
+ // This length is checked once the username has been trimmed and multiple spaces have been collapsed into one.
// Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
'username_max_length' => 48,
- // worker_cooldown (Integer)
- // Cooldown period in seconds after each worker function call.
+ // worker_cooldown (Float)
+ // Cooldown period in seconds before each worker function call.
'worker_cooldown' => 0,
// worker_debug (Boolean)
// List of minutes for the jobs per minute (JPM) calculation
'worker_jpm_range' => '1, 10, 60',
+ // worker_load_cooldown (Integer)
+ // Maximum load that causes a cooldown before each worker function call.
+ 'worker_load_cooldown' => 0,
+
// worker_load_exponent (Integer)
// Default 3, which allows only 25% of the maximum worker queues when server load reaches around 37% of maximum load.
// For a linear response where 25% of worker queues are allowed at 75% of maximum load, set this to 1.
// Setting 0 would allow maximum worker queues at all times, which is not recommended.
'worker_load_exponent' => 3,
+ // worker_max_duration (Array)
+ // Maximum runtime per priority. Worker processes that exceed this runtime will be terminated.
+ 'worker_max_duration' => [
+ Friendica\Core\Worker::PRIORITY_CRITICAL => 720,
+ Friendica\Core\Worker::PRIORITY_HIGH => 10,
+ Friendica\Core\Worker::PRIORITY_MEDIUM => 60,
+ Friendica\Core\Worker::PRIORITY_LOW => 180,
+ Friendica\Core\Worker::PRIORITY_NEGLIGIBLE => 720
+ ],
+
+ // worker_processes_cooldown (Integer)
+ // Maximum number per processes that causes a cooldown before each worker function call.
+ 'worker_processes_cooldown' => 0,
+
// worker_multiple_fetch (Boolean)
// When activated, the worker fetches jobs for multiple workers (not only for itself).
// This is an experimental setting without knowing the performance impact.
// Does not work when "worker_fork" is enabled (Needs more testing)
'worker_multiple_fetch' => false,
-
+
// worker_defer_limit (Integer)
// Per default the systems tries delivering for 15 times before dropping it.
'worker_defer_limit' => 15,
// Must be writable by the ejabberd process. if set then it will prevent the running of multiple processes.
'lockpath' => '',
],
+ 'diaspora' => [
+ // native_photos (Boolean)
+ // If enabled, photos to Diaspora will be transmitted via the "photo" element instead of embedding them to the body.
+ // This is some visual improvement over the embedding but comes with the cost of losing accessibility.
+ // Is is disabled by default until Diaspora eventually will work on issue https://github.com/diaspora/diaspora/issues/8297
+ 'native_photos' => false,
+ ],
'debug' => [
// ap_inbox_log (Boolean)
// Logs every call to /inbox as a JSON file in Friendica's temporary directory
'ap_inbox_log' => false,
- // total_ap_delivery (Boolean)
- // Deliver via AP to every possible receiver and we suppress the delivery to these contacts with other protocols
- 'total_ap_delivery' => false,
- ]
+ // ap_inbox_store_untrusted (Boolean)
+ // Store untrusted content in the inbox entries
+ 'ap_inbox_store_untrusted' => false,
+
+ // ap_log_unknown (Boolean)
+ // Logs every unknown ActivityPub activity
+ 'ap_log_unknown' => false,
+
+ // ap_log_failure (Boolean)
+ // Logs every ActivityPub activity that couldn't be compacted
+ 'ap_log_failure' => false,
+
+ // store_source (Boolean)
+ // Store the source of any post that arrived
+ 'store_source' => false,
+ ],
+ 'smarty3' => [
+ // config_dir (String)
+ // Base working directory for the templating engine, must be writeable by the webserver user
+ 'config_dir' => 'view/smarty3',
+
+ // use_sub_dirs (Boolean)
+ // By default the template cache is stored in several subdirectories.
+ 'use_sub_dirs' => true,
+ ],
];