weekly release 3.9.23+
[moodle.git] / config-dist.php
blob9355072d78556591b6f9843a54fdeb6e98516a2a
1 <?php
2 ///////////////////////////////////////////////////////////////////////////
3 // //
4 // Moodle configuration file //
5 // //
6 // This file should be renamed "config.php" in the top-level directory //
7 // //
8 ///////////////////////////////////////////////////////////////////////////
9 // //
10 // NOTICE OF COPYRIGHT //
11 // //
12 // Moodle - Modular Object-Oriented Dynamic Learning Environment //
13 // http://moodle.org //
14 // //
15 // Copyright (C) 1999 onwards Martin Dougiamas http://moodle.com //
16 // //
17 // This program is free software; you can redistribute it and/or modify //
18 // it under the terms of the GNU General Public License as published by //
19 // the Free Software Foundation; either version 3 of the License, or //
20 // (at your option) any later version. //
21 // //
22 // This program is distributed in the hope that it will be useful, //
23 // but WITHOUT ANY WARRANTY; without even the implied warranty of //
24 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the //
25 // GNU General Public License for more details: //
26 // //
27 // http://www.gnu.org/copyleft/gpl.html //
28 // //
29 ///////////////////////////////////////////////////////////////////////////
30 unset($CFG); // Ignore this line
31 global $CFG; // This is necessary here for PHPUnit execution
32 $CFG = new stdClass();
34 //=========================================================================
35 // 1. DATABASE SETUP
36 //=========================================================================
37 // First, you need to configure the database where all Moodle data //
38 // will be stored. This database must already have been created //
39 // and a username/password created to access it. //
41 $CFG->dbtype = 'pgsql'; // 'pgsql', 'mariadb', 'mysqli', 'sqlsrv' or 'oci'
42 $CFG->dblibrary = 'native'; // 'native' only at the moment
43 $CFG->dbhost = 'localhost'; // eg 'localhost' or 'db.isp.com' or IP
44 $CFG->dbname = 'moodle'; // database name, eg moodle
45 $CFG->dbuser = 'username'; // your database username
46 $CFG->dbpass = 'password'; // your database password
47 $CFG->prefix = 'mdl_'; // prefix to use for all table names
48 $CFG->dboptions = array(
49 'dbpersist' => false, // should persistent database connections be
50 // used? set to 'false' for the most stable
51 // setting, 'true' can improve performance
52 // sometimes
53 'dbsocket' => false, // should connection via UNIX socket be used?
54 // if you set it to 'true' or custom path
55 // here set dbhost to 'localhost',
56 // (please note mysql is always using socket
57 // if dbhost is 'localhost' - if you need
58 // local port connection use '127.0.0.1')
59 'dbport' => '', // the TCP port number to use when connecting
60 // to the server. keep empty string for the
61 // default port
62 'dbhandlesoptions' => false,// On PostgreSQL poolers like pgbouncer don't
63 // support advanced options on connection.
64 // If you set those in the database then
65 // the advanced settings will not be sent.
66 'dbcollation' => 'utf8mb4_unicode_ci', // MySQL has partial and full UTF-8
67 // support. If you wish to use partial UTF-8
68 // (three bytes) then set this option to
69 // 'utf8_unicode_ci', otherwise this option
70 // can be removed for MySQL (by default it will
71 // use 'utf8mb4_unicode_ci'. This option should
72 // be removed for all other databases.
73 // 'extrainfo' => [], // Extra information for the DB driver, e.g. SQL Server,
74 // has additional configuration according to its environment,
75 // which the administrator can specify to alter and
76 // override any connection options.
77 // 'fetchbuffersize' => 100000, // On PostgreSQL, this option sets a limit
78 // on the number of rows that are fetched into
79 // memory when doing a large recordset query
80 // (e.g. search indexing). Default is 100000.
81 // Uncomment and set to a value to change it,
82 // or zero to turn off the limit. You need to
83 // set to zero if you are using pg_bouncer in
84 // 'transaction' mode (it is fine in 'session'
85 // mode).
87 'connecttimeout' => null, // Set connect timeout in seconds. Not all drivers support it.
88 'readonly' => [ // Set to read-only slave details, to get safe reads
89 // from there instead of the master node. Optional.
90 // Currently supported by pgsql and mysqli variety classes.
91 // If not supported silently ignored.
92 'instance' => [ // Readonly slave connection parameters
94 'dbhost' => 'slave.dbhost',
95 'dbport' => '', // Defaults to master port
96 'dbuser' => '', // Defaults to master user
97 'dbpass' => '', // Defaults to master password
99 [...],
102 Instance(s) can alternatively be specified as:
104 'instance' => 'slave.dbhost',
105 'instance' => ['slave.dbhost1', 'slave.dbhost2'],
106 'instance' => ['dbhost' => 'slave.dbhost', 'dbport' => '', 'dbuser' => '', 'dbpass' => ''],
108 'connecttimeout' => 2, // Set read-only slave connect timeout in seconds. See above.
109 'latency' => 0.5, // Set read-only slave sync latency in seconds.
110 // When 'latency' seconds have lapsed after an update to a table
111 // it is deemed safe to use readonly slave for reading from the table.
112 // It is optional. If omitted once written to a table it will always
113 // use master handle for reading.
114 // Lower values increase the performance, but setting it too low means
115 // missing the master-slave sync.
116 'exclude_tables' => [ // Tables to exclude from read-only slave feature.
117 'table1', // Should not be used, unless in rare cases when some area of the system
118 'table2', // is malfunctioning and you still want to use readonly feature.
119 ], // Then one can exclude offending tables while investigating.
121 More info available in lib/dml/moodle_read_slave_trait.php where the feature is implemented.
124 // For all database config settings see https://docs.moodle.org/en/Database_settings
128 //=========================================================================
129 // 2. WEB SITE LOCATION
130 //=========================================================================
131 // Now you need to tell Moodle where it is located. Specify the full
132 // web address to where moodle has been installed. If your web site
133 // is accessible via multiple URLs then choose the most natural one
134 // that your students would use. Do not include a trailing slash
136 // If you need both intranet and Internet access please read
137 // http://docs.moodle.org/en/masquerading
139 $CFG->wwwroot = 'http://example.com/moodle';
142 //=========================================================================
143 // 3. DATA FILES LOCATION
144 //=========================================================================
145 // Now you need a place where Moodle can save uploaded files. This
146 // directory should be readable AND WRITEABLE by the web server user
147 // (usually 'nobody' or 'apache'), but it should not be accessible
148 // directly via the web.
150 // - On hosting systems you might need to make sure that your "group" has
151 // no permissions at all, but that "others" have full permissions.
153 // - On Windows systems you might specify something like 'c:\moodledata'
155 $CFG->dataroot = '/home/example/moodledata';
158 //=========================================================================
159 // 4. DATA FILES PERMISSIONS
160 //=========================================================================
161 // The following parameter sets the permissions of new directories
162 // created by Moodle within the data directory. The format is in
163 // octal format (as used by the Unix utility chmod, for example).
164 // The default is usually OK, but you may want to change it to 0750
165 // if you are concerned about world-access to the files (you will need
166 // to make sure the web server process (eg Apache) can access the files.
167 // NOTE: the prefixed 0 is important, and don't use quotes.
169 $CFG->directorypermissions = 02777;
172 //=========================================================================
173 // 5. DIRECTORY LOCATION (most people can just ignore this setting)
174 //=========================================================================
175 // A very few webhosts use /admin as a special URL for you to access a
176 // control panel or something. Unfortunately this conflicts with the
177 // standard location for the Moodle admin pages. You can work around this
178 // by renaming the admin directory in your installation, and putting that
179 // new name here. eg "moodleadmin". This should fix all admin links in Moodle.
180 // After any change you need to visit your new admin directory
181 // and purge all caches.
183 $CFG->admin = 'admin';
186 //=========================================================================
187 // 6. OTHER MISCELLANEOUS SETTINGS (ignore these for new installations)
188 //=========================================================================
190 // These are additional tweaks for which no GUI exists in Moodle yet.
192 // Starting in PHP 5.3 administrators should specify default timezone
193 // in PHP.ini, you can also specify it here if needed.
194 // See details at: http://php.net/manual/en/function.date-default-timezone-set.php
195 // List of time zones at: http://php.net/manual/en/timezones.php
196 // date_default_timezone_set('Australia/Perth');
198 // Change the key pair lifetime for Moodle Networking
199 // The default is 28 days. You would only want to change this if the key
200 // was not getting regenerated for any reason. You would probably want
201 // make it much longer. Note that you'll need to delete and manually update
202 // any existing key.
203 // $CFG->mnetkeylifetime = 28;
205 // Not recommended: Set the following to true to allow the use
206 // off non-Moodle standard characters in usernames.
207 // $CFG->extendedusernamechars = true;
209 // Allow user passwords to be included in backup files. Very dangerous
210 // setting as far as it publishes password hashes that can be unencrypted
211 // if the backup file is publicy available. Use it only if you can guarantee
212 // that all your backup files remain only privacy available and are never
213 // shared out from your site/institution!
214 // $CFG->includeuserpasswordsinbackup = true;
216 // Completely disable user creation when restoring a course, bypassing any
217 // permissions granted via roles and capabilities. Enabling this setting
218 // results in the restore process stopping when a user attempts to restore a
219 // course requiring users to be created.
220 // $CFG->disableusercreationonrestore = true;
222 // Keep the temporary directories used by backup and restore without being
223 // deleted at the end of the process. Use it if you want to debug / view
224 // all the information stored there after the process has ended. Note that
225 // those directories may be deleted (after some ttl) both by cron and / or
226 // by new backup / restore invocations.
227 // $CFG->keeptempdirectoriesonbackup = true;
229 // Modify the restore process in order to force the "user checks" to assume
230 // that the backup originated from a different site, so detection of matching
231 // users is performed with different (more "relaxed") rules. Note that this is
232 // only useful if the backup file has been created using Moodle < 1.9.4 and the
233 // site has been rebuilt from scratch using backup files (not the best way btw).
234 // If you obtain user conflicts on restore, rather than enabling this setting
235 // permanently, try restoring the backup on a different site, back it up again
236 // and then restore on the target server.
237 // $CFG->forcedifferentsitecheckingusersonrestore = true;
239 // Force the backup system to continue to create backups in the legacy zip
240 // format instead of the new tgz format. Does not affect restore, which
241 // auto-detects the underlying file format.
242 // $CFG->usezipbackups = true;
244 // Prevent stats processing and hide the GUI
245 // $CFG->disablestatsprocessing = true;
247 // Setting this to true will enable admins to edit any post at any time
248 // $CFG->admineditalways = true;
250 // These variables define DEFAULT block variables for new courses
251 // If this one is set it overrides all others and is the only one used.
252 // $CFG->defaultblocks_override = 'activity_modules,search_forums,course_list:news_items,calendar_upcoming,recent_activity';
254 // These variables define the specific settings for defined course formats.
255 // They override any settings defined in the formats own config file.
256 // $CFG->defaultblocks_site = 'site_main_menu,course_list:course_summary,calendar_month';
257 // $CFG->defaultblocks_social = 'search_forums,calendar_month,calendar_upcoming,social_activities,recent_activity,course_list';
258 // $CFG->defaultblocks_topics = 'activity_modules,search_forums,course_list:news_items,calendar_upcoming,recent_activity';
259 // $CFG->defaultblocks_weeks = 'activity_modules,search_forums,course_list:news_items,calendar_upcoming,recent_activity';
261 // These blocks are used when no other default setting is found.
262 // $CFG->defaultblocks = 'activity_modules,search_forums,course_list:news_items,calendar_upcoming,recent_activity';
264 // You can specify a different class to be created for the $PAGE global, and to
265 // compute which blocks appear on each page. However, I cannot think of any good
266 // reason why you would need to change that. It just felt wrong to hard-code the
267 // the class name. You are strongly advised not to use these to settings unless
268 // you are absolutely sure you know what you are doing.
269 // $CFG->moodlepageclass = 'moodle_page';
270 // $CFG->moodlepageclassfile = "$CFG->dirroot/local/myplugin/mypageclass.php";
271 // $CFG->blockmanagerclass = 'block_manager';
272 // $CFG->blockmanagerclassfile = "$CFG->dirroot/local/myplugin/myblockamanagerclass.php";
274 // Seconds for files to remain in caches. Decrease this if you are worried
275 // about students being served outdated versions of uploaded files.
276 // $CFG->filelifetime = 60*60*6;
278 // Some web servers can offload the file serving from PHP process,
279 // comment out one the following options to enable it in Moodle:
280 // $CFG->xsendfile = 'X-Sendfile'; // Apache {@see https://tn123.org/mod_xsendfile/}
281 // $CFG->xsendfile = 'X-LIGHTTPD-send-file'; // Lighttpd {@see http://redmine.lighttpd.net/projects/lighttpd/wiki/X-LIGHTTPD-send-file}
282 // $CFG->xsendfile = 'X-Accel-Redirect'; // Nginx {@see http://wiki.nginx.org/XSendfile}
283 // If your X-Sendfile implementation (usually Nginx) uses directory aliases specify them
284 // in the following array setting:
285 // $CFG->xsendfilealiases = array(
286 // '/dataroot/' => $CFG->dataroot,
287 // '/cachedir/' => '/var/www/moodle/cache', // for custom $CFG->cachedir locations
288 // '/localcachedir/' => '/var/local/cache', // for custom $CFG->localcachedir locations
289 // '/tempdir/' => '/var/www/moodle/temp', // for custom $CFG->tempdir locations
290 // '/filedir' => '/var/www/moodle/filedir', // for custom $CFG->filedir locations
291 // );
293 // YUI caching may be sometimes improved by slasharguments:
294 // $CFG->yuislasharguments = 1;
295 // Some servers may need a special rewrite rule to work around internal path length limitations:
296 // RewriteRule (^.*/theme/yui_combo\.php)(/.*) $1?file=$2
299 // Following settings may be used to select session driver, uncomment only one of the handlers.
300 // Database session handler (not compatible with MyISAM):
301 // $CFG->session_handler_class = '\core\session\database';
302 // $CFG->session_database_acquire_lock_timeout = 120;
304 // File session handler (file system locking required):
305 // $CFG->session_handler_class = '\core\session\file';
306 // $CFG->session_file_save_path = $CFG->dataroot.'/sessions';
308 // Memcached session handler (requires memcached server and extension):
309 // $CFG->session_handler_class = '\core\session\memcached';
310 // $CFG->session_memcached_save_path = '127.0.0.1:11211';
311 // $CFG->session_memcached_prefix = 'memc.sess.key.';
312 // $CFG->session_memcached_acquire_lock_timeout = 120;
313 // $CFG->session_memcached_lock_expire = 7200; // Ignored if PECL memcached is below version 2.2.0
314 // $CFG->session_memcached_lock_retry_sleep = 150; // Spin-lock retry sleeptime (msec). Only effective
315 // // for tuning php-memcached 3.0.x (PHP 7)
317 // Redis session handler (requires redis server and redis extension):
318 // $CFG->session_handler_class = '\core\session\redis';
319 // $CFG->session_redis_host = '127.0.0.1';
320 // $CFG->session_redis_port = 6379; // Optional.
321 // $CFG->session_redis_database = 0; // Optional, default is db 0.
322 // $CFG->session_redis_auth = ''; // Optional, default is don't set one.
323 // $CFG->session_redis_prefix = ''; // Optional, default is don't set one.
324 // $CFG->session_redis_acquire_lock_timeout = 120;
325 // $CFG->session_redis_lock_expire = 7200;
326 // $CFG->session_redis_lock_retry = 100; // Optional wait between lock attempts in ms, default is 100.
327 // // After 5 seconds it will throttle down to once per second.
328 // Use the igbinary serializer instead of the php default one. Note that phpredis must be compiled with
329 // igbinary support to make the setting to work. Also, if you change the serializer you have to flush the database!
330 // $CFG->session_redis_serializer_use_igbinary = false; // Optional, default is PHP builtin serializer.
332 // Please be aware that when selecting Memcached for sessions that it is advised to use a dedicated
333 // memcache server. The memcached extension does not provide isolated environments for individual uses.
334 // Using the same server for other purposes (MUC for example) can lead to sessions being prematurely removed should
335 // the other uses of the server purge the cache.
337 // Following setting allows you to alter how frequently is timemodified updated in sessions table.
338 // $CFG->session_update_timemodified_frequency = 20; // In seconds.
340 // If this setting is set to true, then Moodle will track the IP of the
341 // current user to make sure it hasn't changed during a session. This
342 // will prevent the possibility of sessions being hijacked via XSS, but it
343 // may break things for users coming using proxies that change all the time,
344 // like AOL.
345 // $CFG->tracksessionip = true;
347 // The following lines are for handling email bounces.
348 // $CFG->handlebounces = true;
349 // $CFG->minbounces = 10;
350 // $CFG->bounceratio = .20;
351 // The next lines are needed both for bounce handling and any other email to module processing.
352 // mailprefix must be EXACTLY four characters.
353 // Uncomment and customise this block for Postfix
354 // $CFG->mailprefix = 'mdl+'; // + is the separator for Exim and Postfix.
355 // $CFG->mailprefix = 'mdl-'; // - is the separator for qmail
356 // $CFG->maildomain = 'youremaildomain.com';
358 // Enable when setting up advanced reverse proxy load balancing configurations,
359 // it may be also necessary to enable this when using port forwarding.
360 // $CFG->reverseproxy = true;
362 // Enable when using external SSL appliance for performance reasons.
363 // Please note that site may be accessible via http: or https:, but not both!
364 // $CFG->sslproxy = true;
366 // This setting will cause the userdate() function not to fix %d in
367 // date strings, and just let them show with a zero prefix.
368 // $CFG->nofixday = true;
370 // This setting will make some graphs (eg user logs) use lines instead of bars
371 // $CFG->preferlinegraphs = true;
373 // This setting allows you to specify a class to rewrite outgoing urls
374 // enabling 'clean urls' in conjunction with an apache / nginx handler.
375 // The handler must implement \core\output\url_rewriter.
376 // $CFG->urlrewriteclass = '\local_cleanurls\url_rewriter';
378 // Enabling this will allow custom scripts to replace existing moodle scripts.
379 // For example: if $CFG->customscripts/course/view.php exists then
380 // it will be used instead of $CFG->wwwroot/course/view.php
381 // At present this will only work for files that include config.php and are called
382 // as part of the url (index.php is implied).
383 // Some examples are:
384 // http://my.moodle.site/course/view.php
385 // http://my.moodle.site/index.php
386 // http://my.moodle.site/admin (index.php implied)
387 // Custom scripts should not include config.php
388 // Warning: Replacing standard moodle scripts may pose security risks and/or may not
389 // be compatible with upgrades. Use this option only if you are aware of the risks
390 // involved.
391 // Specify the full directory path to the custom scripts
392 // $CFG->customscripts = '/home/example/customscripts';
394 // Performance profiling
396 // If you set Debug to "Yes" in the Configuration->Variables page some
397 // performance profiling data will show up on your footer (in default theme).
398 // With these settings you get more granular control over the capture
399 // and printout of the data
401 // Capture performance profiling data
402 // define('MDL_PERF' , true);
404 // Capture additional data from DB
405 // define('MDL_PERFDB' , true);
407 // Print to log (for passive profiling of production servers)
408 // define('MDL_PERFTOLOG' , true);
410 // Print to footer (works with the default theme)
411 // define('MDL_PERFTOFOOT', true);
413 // Enable earlier profiling that causes more code to be covered
414 // on every request (db connections, config load, other inits...).
415 // Requires extra configuration to be defined in config.php like:
416 // profilingincluded, profilingexcluded, profilingautofrec,
417 // profilingallowme, profilingallowall, profilinglifetime
418 // $CFG->earlyprofilingenabled = true;
420 // Disable database storage for profile data.
421 // When using an exernal plugin to store profiling data it is often
422 // desirable to not store the data in the database.
424 // $CFG->disableprofilingtodatabase = true;
426 // Force displayed usernames
427 // A little hack to anonymise user names for all students. If you set these
428 // then all non-teachers will always see these for every person.
429 // $CFG->forcefirstname = 'Bruce';
430 // $CFG->forcelastname = 'Simpson';
432 // The following setting will turn on username logging into Apache log. For full details regarding setting
433 // up of this function please refer to the install section of the document.
434 // $CFG->apacheloguser = 0; // Turn this feature off. Default value.
435 // $CFG->apacheloguser = 1; // Log user id.
436 // $CFG->apacheloguser = 2; // Log full name in cleaned format. ie, Darth Vader will be displayed as darth_vader.
437 // $CFG->apacheloguser = 3; // Log username.
438 // To get the values logged in Apache's log, add to your httpd.conf
439 // the following statements. In the General part put:
440 // LogFormat "%h %l %{MOODLEUSER}n %t \"%r\" %s %b \"%{Referer}i\" \"%{User-Agent}i\"" moodleformat
441 // And in the part specific to your Moodle install / virtualhost:
442 // CustomLog "/your/path/to/log" moodleformat
444 // Alternatively for other webservers such as nginx, you can instead have the username sent via a http header
445 // 'X-MOODLEUSER' which can be saved in the logfile and then stripped out before being sent to the browser:
446 // $CFG->headerloguser = 0; // Turn this feature off. Default value.
447 // $CFG->headerloguser = 1; // Log user id.
448 // $CFG->headerloguser = 2; // Log full name in cleaned format. ie, Darth Vader will be displayed as darth_vader.
449 // $CFG->headerloguser = 3; // Log username.
451 // CAUTION: Use of this option will expose usernames in the Apache / nginx log,
452 // If you are going to publish your log, or the output of your web stats analyzer
453 // this will weaken the security of your website.
455 // Email database connection errors to someone. If Moodle cannot connect to the
456 // database, then email this address with a notice.
458 // $CFG->emailconnectionerrorsto = 'your@emailaddress.com';
460 // Set the priority of themes from highest to lowest. This is useful (for
461 // example) in sites where the user theme should override all other theme
462 // settings for accessibility reasons. You can also disable types of themes
463 // (other than site) by removing them from the array. The default setting is:
465 // $CFG->themeorder = array('course', 'category', 'session', 'user', 'cohort', 'site');
467 // NOTE: course, category, session, user, cohort themes still require the
468 // respective settings to be enabled
470 // It is possible to add extra themes directory stored outside of $CFG->dirroot.
471 // This local directory does not have to be accessible from internet.
473 // $CFG->themedir = '/location/of/extra/themes';
475 // It is possible to specify different cache and temp directories, use local fast filesystem
476 // for normal web servers. Server clusters MUST use shared filesystem for cachedir!
477 // Localcachedir is intended for server clusters, it does not have to be shared by cluster nodes.
478 // The directories must not be accessible via web.
480 // $CFG->tempdir = '/var/www/moodle/temp'; // Directory MUST BE SHARED by all cluster nodes.
481 // $CFG->cachedir = '/var/www/moodle/cache'; // Directory MUST BE SHARED by all cluster nodes, locking required.
482 // $CFG->localcachedir = '/var/local/cache'; // Intended for local node caching.
484 // It is possible to specify a different backup temp directory, use local fast filesystem
485 // for normal web servers. Server clusters MUST use shared filesystem for backuptempdir!
486 // The directory must not be accessible via web.
488 // $CFG->backuptempdir = '/var/www/moodle/backuptemp'; // Directory MUST BE SHARED by all cluster nodes.
490 // Some filesystems such as NFS may not support file locking operations.
491 // Locking resolves race conditions and is strongly recommended for production servers.
492 // $CFG->preventfilelocking = false;
494 // Site default language can be set via standard administration interface. If you
495 // want to have initial error messages for eventual database connection problems
496 // localized too, you have to set your language code here.
498 // $CFG->lang = 'yourlangcode'; // for example 'cs'
500 // When Moodle is about to perform an intensive operation it raises PHP's memory
501 // limit. The following setting should be used on large sites to set the raised
502 // memory limit to something higher.
503 // The value for the settings should be a valid PHP memory value. e.g. 512M, 1G
505 // $CFG->extramemorylimit = '1024M';
507 // Moodle 2.4 introduced a new cache API.
508 // The cache API stores a configuration file within the Moodle data directory and
509 // uses that rather than the database in order to function in a stand-alone manner.
510 // Using altcacheconfigpath you can change the location where this config file is
511 // looked for.
512 // It can either be a directory in which to store the file, or the full path to the
513 // file if you want to take full control. Either way it must be writable by the
514 // webserver.
516 // $CFG->altcacheconfigpath = '/var/www/shared/moodle.cache.config.php
518 // Use the following flag to completely disable the Available update notifications
519 // feature and hide it from the server administration UI.
521 // $CFG->disableupdatenotifications = true;
523 // Use the following flag to completely disable the installation of plugins
524 // (new plugins, available updates and missing dependencies) and related
525 // features (such as cancelling the plugin installation or upgrade) via the
526 // server administration web interface.
528 // $CFG->disableupdateautodeploy = true;
530 // Use the following flag to disable the warning on the system notifications page
531 // about present development libraries. This flag will not disable the warning within
532 // the security overview report. Use this flag only if you really have prohibited web
533 // access to the development libraries in your webserver configuration.
535 // $CFG->disabledevlibdirscheck = true;
537 // Use the following flag to disable modifications to scheduled tasks
538 // whilst still showing the state of tasks.
540 // $CFG->preventscheduledtaskchanges = true;
542 // As of version 2.4 Moodle serves icons as SVG images if the users browser appears
543 // to support SVG.
544 // For those wanting to control the serving of SVG images the following setting can
545 // be defined in your config.php.
546 // If it is not defined then the default (browser detection) will occur.
548 // To ensure they are always used when available:
549 // $CFG->svgicons = true;
551 // To ensure they are never used even when available:
552 // $CFG->svgicons = false;
554 // Some administration options allow setting the path to executable files. This can
555 // potentially cause a security risk. Set this option to true to disable editing
556 // those config settings via the web. They will need to be set explicitly in the
557 // config.php file
558 // $CFG->preventexecpath = true;
560 // Use the following flag to set userid for noreply user. If not set then moodle will
561 // create dummy user and use -ve value as user id.
562 // $CFG->noreplyuserid = -10;
564 // As of version 2.6 Moodle supports admin to set support user. If not set, all mails
565 // will be sent to supportemail.
566 // $CFG->supportuserid = -20;
568 // Moodle 2.7 introduces a locking api for critical tasks (e.g. cron).
569 // The default locking system to use is DB locking for Postgres, MySQL, MariaDB and
570 // file locking for Oracle and SQLServer. If $CFG->preventfilelocking is set, then the
571 // default will always be DB locking. It can be manually set to one of the lock
572 // factory classes listed below, or one of your own custom classes implementing the
573 // \core\lock\lock_factory interface.
575 // $CFG->lock_factory = "auto";
577 // The list of available lock factories is:
579 // "\\core\\lock\\file_lock_factory" - File locking
580 // Uses lock files stored by default in the dataroot. Whether this
581 // works on clusters depends on the file system used for the dataroot.
583 // "\\core\\lock\\db_record_lock_factory" - DB locking based on table rows.
585 // "\\core\\lock\\mysql_lock_factory" - DB locking based on MySQL / MariaDB locks.
587 // "\\core\\lock\\postgres_lock_factory" - DB locking based on postgres advisory locks.
589 // Settings used by the lock factories
591 // Location for lock files used by the File locking factory. This must exist
592 // on a shared file system that supports locking.
593 // $CFG->file_lock_root = $CFG->dataroot . '/lock';
596 // Alternative task logging.
597 // Since Moodle 3.7 the output of al scheduled and adhoc tasks is stored in the database and it is possible to use an
598 // alternative task logging mechanism.
599 // To set the alternative task logging mechanism in config.php you can use the following settings, providing the
600 // alternative class name that will be auto-loaded.
602 // $CFG->task_log_class = '\\local_mytasklogger\\logger';
604 // Moodle 2.9 allows administrators to customise the list of supported file types.
605 // To add a new filetype or override the definition of an existing one, set the
606 // customfiletypes variable like this:
608 // $CFG->customfiletypes = array(
609 // (object)array(
610 // 'extension' => 'frog',
611 // 'icon' => 'archive',
612 // 'type' => 'application/frog',
613 // 'customdescription' => 'Amphibian-related file archive'
614 // )
615 // );
617 // The extension, icon, and type fields are required. The icon field can refer to
618 // any icon inside the pix/f folder. You can also set the customdescription field
619 // (shown above) and (for advanced use) the groups, string, and defaulticon fields.
621 // Upgrade key
623 // If the upgrade key is defined here, then the value must be provided every time
624 // the site is being upgraded though the web interface, regardless of whether the
625 // administrator is logged in or not. This prevents anonymous access to the upgrade
626 // screens where the real authentication and authorization mechanisms can not be
627 // relied on.
629 // It is strongly recommended to use a value different from your real account
630 // password.
632 // $CFG->upgradekey = 'put_some_password-like_value_here';
634 // Document conversion limit
636 // How many times the background task should attempt to convert a given attempt
637 // before removing it from the queue. Currently this limit is only used by the
638 // mod_assign conversion task.
640 // $CFG->conversionattemptlimit = 3;
642 // Font used in exported PDF files. When generating a PDF, Moodle embeds a subset of
643 // the font in the PDF file so it will be readable on the widest range of devices.
644 // The default font is 'freesans' which is part of the GNU FreeFont collection.
646 // $CFG->pdfexportfont = 'freesans';
648 // Use the following flag to enable messagingallusers and set the default preference
649 // value for existing users to allow them to be contacted by other site users.
651 // $CFG->keepmessagingallusersenabled = true;
653 // Disable login token validation for login pages. Login token validation is enabled
654 // by default unless $CFG->alternateloginurl is set.
656 // $CFG->disablelogintoken = true;
658 // Moodle 3.7+ checks that cron is running frequently. If the time between cron runs
659 // is greater than this value (in seconds), you get a warning on the admin page. (This
660 // setting only controls whether or not the warning appears, it has no other effect.)
662 // $CFG->expectedcronfrequency = 200;
664 // Moodle 3.9+ checks how old tasks are in the ad hoc queue and warns at 10 minutes
665 // and errors at 4 hours. Set these to override these limits:
667 // $CFG->adhoctaskagewarn = 10 * 60;
668 // $CFG->adhoctaskageerror = 4 * 60 * 60;
670 // Session lock warning threshold. Long running pages should release the session using \core\session\manager::write_close().
671 // Set this threshold to any value greater than 0 to add developer warnings when a page locks the session for too long.
672 // The session should rarely be locked for more than 1 second. The input should be in seconds and may be a float.
674 // $CFG->debugsessionlock = 5;
676 // There are times when a session lock is not required during a request. For a page/service to opt-in whether or not a
677 // session lock is required this setting must first be set to 'true'.
678 // This is an experimental issue. The session store can not be in the session, please
679 // see https://docs.moodle.org/en/Session_handling#Read_only_sessions.
681 // $CFG->enable_read_only_sessions = true;
683 // Uninstall plugins from CLI only. This stops admins from uninstalling plugins from the graphical admin
684 // user interface, and forces plugins to be uninstalled from the Command Line tool only, found at
685 // admin/cli/plugin_uninstall.php.
687 // $CFG->uninstallclionly = true;
690 // Customise question bank display
692 // The display of Moodle's question bank is made up of a number of columns.
693 // You can customise this display by giving a comma-separated list of column class
694 // names here. Each class must be a subclass of \core_question\bank\column_base.
695 // For example you might define a class like
696 // class \local_qbank_extensions\my_column extends \core_question\bank\column_base
697 // in a local plugin, then add it to the list here. At the time of writing,
698 // the default question bank display is equivalent to the following, but you might like
699 // to check the latest default in question/classes/bank/view.php before setting this.
701 // $CFG->questionbankcolumns = 'checkbox_column,question_type_column,'
702 // . 'question_name_idnumber_tags_column,edit_menu_column,'
703 // . 'tags_action_column,edit_action_column,copy_action_column,'
704 // . 'preview_action_column,delete_action_column,export_xml_action_column,'
705 // . 'creator_name_column,modifier_name_column';
707 // Forum summary report
709 // In order for the forum summary report to calculate word count and character count data, those details are now stored
710 // for each post in the database when posts are created or updated. For posts that existed prior to a Moodle 3.8 upgrade,
711 // these are calculated by the refresh_forum_post_counts ad-hoc task in chunks of 5000 posts per batch by default.
712 // That default can be overridden by setting an integer value for $CFG->forumpostcountchunksize.
714 // $CFG->forumpostcountchunksize = 5000;
716 //=========================================================================
717 // 7. SETTINGS FOR DEVELOPMENT SERVERS - not intended for production use!!!
718 //=========================================================================
720 // Force a debugging mode regardless the settings in the site administration
721 // @error_reporting(E_ALL | E_STRICT); // NOT FOR PRODUCTION SERVERS!
722 // @ini_set('display_errors', '1'); // NOT FOR PRODUCTION SERVERS!
723 // $CFG->debug = (E_ALL | E_STRICT); // === DEBUG_DEVELOPER - NOT FOR PRODUCTION SERVERS!
724 // $CFG->debugdisplay = 1; // NOT FOR PRODUCTION SERVERS!
726 // You can specify a comma separated list of user ids that that always see
727 // debug messages, this overrides the debug flag in $CFG->debug and $CFG->debugdisplay
728 // for these users only.
729 // $CFG->debugusers = '2';
731 // Prevent theme caching
732 // $CFG->themedesignermode = true; // NOT FOR PRODUCTION SERVERS!
734 // Enable verbose debug information during fetching of email messages from IMAP server.
735 // $CFG->debugimap = true;
737 // Enable verbose debug information during sending of email messages to SMTP server.
738 // Note: also requires $CFG->debug set to DEBUG_DEVELOPER.
739 // $CFG->debugsmtp = true;
741 // Prevent JS caching
742 // $CFG->cachejs = false; // NOT FOR PRODUCTION SERVERS!
744 // Prevent Template caching
745 // $CFG->cachetemplates = false; // NOT FOR PRODUCTION SERVERS!
747 // Restrict which YUI logging statements are shown in the browser console.
748 // For details see the upstream documentation:
749 // http://yuilibrary.com/yui/docs/api/classes/config.html#property_logInclude
750 // http://yuilibrary.com/yui/docs/api/classes/config.html#property_logExclude
751 // $CFG->yuiloginclude = array(
752 // 'moodle-course-categoryexpander' => true,
753 // );
754 // $CFG->yuilogexclude = array(
755 // 'moodle-core-notification' => true,
756 // );
758 // Set the minimum log level for YUI logging statements.
759 // For details see the upstream documentation:
760 // http://yuilibrary.com/yui/docs/api/classes/config.html#property_logLevel
761 // $CFG->yuiloglevel = 'debug';
763 // Prevent core_string_manager application caching
764 // $CFG->langstringcache = false; // NOT FOR PRODUCTION SERVERS!
766 // When working with production data on test servers, no emails or other messages
767 // should ever be send to real users
768 // $CFG->noemailever = true; // NOT FOR PRODUCTION SERVERS!
770 // Divert all outgoing emails to this address to test and debug emailing features
771 // $CFG->divertallemailsto = 'root@localhost.local'; // NOT FOR PRODUCTION SERVERS!
773 // Except for certain email addresses you want to let through for testing. Accepts
774 // a comma separated list of regexes.
775 // $CFG->divertallemailsexcept = 'tester@dev.com, fred(\+.*)?@example.com'; // NOT FOR PRODUCTION SERVERS!
777 // Uncomment if you want to allow empty comments when modifying install.xml files.
778 // $CFG->xmldbdisablecommentchecking = true; // NOT FOR PRODUCTION SERVERS!
780 // Since 2.0 sql queries are not shown during upgrade by default.
781 // Please note that this setting may produce very long upgrade page on large sites.
782 // $CFG->upgradeshowsql = true; // NOT FOR PRODUCTION SERVERS!
784 // Add SQL queries to the output of cron, just before their execution
785 // $CFG->showcronsql = true;
787 // Force developer level debug and add debug info to the output of cron
788 // $CFG->showcrondebugging = true;
790 // Force result of checks used to determine whether a site is considered "public" or not (such as for site registration).
791 // $CFG->site_is_public = false;
793 //=========================================================================
794 // 8. FORCED SETTINGS
795 //=========================================================================
796 // It is possible to specify normal admin settings here, the point is that
797 // they can not be changed through the standard admin settings pages any more.
799 // Core settings are specified directly via assignment to $CFG variable.
800 // Example:
801 // $CFG->somecoresetting = 'value';
803 // Plugin settings have to be put into a special array.
804 // Example:
805 // $CFG->forced_plugin_settings = array('pluginname' => array('settingname' => 'value', 'secondsetting' => 'othervalue'),
806 // 'otherplugin' => array('mysetting' => 'myvalue', 'thesetting' => 'thevalue'));
807 // Module default settings with advanced/locked checkboxes can be set too. To do this, add
808 // an extra config with '_adv' or '_locked' as a suffix and set the value to true or false.
809 // Example:
810 // $CFG->forced_plugin_settings = array('pluginname' => array('settingname' => 'value', 'settingname_locked' => true, 'settingname_adv' => true));
812 //=========================================================================
813 // 9. PHPUNIT SUPPORT
814 //=========================================================================
815 // $CFG->phpunit_prefix = 'phpu_';
816 // $CFG->phpunit_dataroot = '/home/example/phpu_moodledata';
817 // $CFG->phpunit_directorypermissions = 02777; // optional
818 // $CFG->phpunit_profilingenabled = true; // optional to profile PHPUnit runs.
821 //=========================================================================
822 // 10. SECRET PASSWORD SALT
823 //=========================================================================
824 // A site-wide password salt is no longer used in new installations.
825 // If upgrading from 2.6 or older, keep all existing salts in config.php file.
827 // $CFG->passwordsaltmain = 'a_very_long_random_string_of_characters#@6&*1';
829 // You may also have some alternative salts to allow migration from previously
830 // used salts.
832 // $CFG->passwordsaltalt1 = '';
833 // $CFG->passwordsaltalt2 = '';
834 // $CFG->passwordsaltalt3 = '';
835 // ....
836 // $CFG->passwordsaltalt19 = '';
837 // $CFG->passwordsaltalt20 = '';
840 //=========================================================================
841 // 11. BEHAT SUPPORT
842 //=========================================================================
843 // Behat test site needs a unique www root, data directory and database prefix:
845 // $CFG->behat_wwwroot = 'http://127.0.0.1/moodle';
846 // $CFG->behat_prefix = 'bht_';
847 // $CFG->behat_dataroot = '/home/example/bht_moodledata';
849 // You can override default Moodle configuration for Behat and add your own
850 // params; here you can add more profiles, use different Mink drivers than Selenium...
851 // These params would be merged with the default Moodle behat.yml, giving priority
852 // to the ones specified here. The array format is YAML, following the Behat
853 // params hierarchy. More info: http://docs.behat.org/guides/7.config.html
854 // Example:
855 // $CFG->behat_config = array(
856 // 'Mac-Firefox' => array(
857 // 'suites' => array (
858 // 'default' => array(
859 // 'filters' => array(
860 // 'tags' => '~@_file_upload'
861 // ),
862 // ),
863 // ),
864 // 'extensions' => array(
865 // 'Behat\MinkExtension' => array(
866 // 'webddriver' => array(
867 // 'browser' => 'firefox',
868 // 'capabilities' => array(
869 // 'platform' => 'OS X 10.6',
870 // 'version' => 20
871 // )
872 // )
873 // )
874 // )
875 // ),
876 // 'Mac-Safari' => array(
877 // 'extensions' => array(
878 // 'Behat\MinkExtension' => array(
879 // 'webddriver' => array(
880 // 'browser' => 'safari',
881 // 'capabilities' => array(
882 // 'platform' => 'OS X 10.8',
883 // 'version' => 6
884 // )
885 // )
886 // )
887 // )
888 // )
889 // );
890 // You can also use the following config to override default Moodle configuration for Behat.
891 // This config is limited to default suite and will be supported in later versions.
892 // It will have precedence over $CFG->behat_config.
893 // $CFG->behat_profiles = array(
894 // 'phantomjs' => array(
895 // 'browser' => 'phantomjs',
896 // 'tags' => '~@_file_upload&&~@_alert&&~@_bug_phantomjs',
897 // 'wd_host' => 'http://127.0.0.1:4443/wd/hub',
898 // 'capabilities' => array(
899 // 'platform' => 'Linux',
900 // 'version' => 2.1
901 // )
902 // ),
903 // );
905 // All this page's extra Moodle settings are compared against a white list of allowed settings
906 // (the basic and behat_* ones) to avoid problems with production environments. This setting can be
907 // used to expand the default white list with an array of extra settings.
908 // Example:
909 // $CFG->behat_extraallowedsettings = array('somecoresetting', ...);
911 // You should explicitly allow the usage of the deprecated behat steps, otherwise an exception will
912 // be thrown when using them. The setting is disabled by default.
913 // Example:
914 // $CFG->behat_usedeprecated = true;
916 // If you are using a slow machine, it may help to increase the timeouts that Behat uses. The
917 // following example will increase timeouts by a factor of 3 (using 30 seconds instead of 10
918 // seconds, for instance).
919 // Example:
920 // $CFG->behat_increasetimeout = 3;
922 // Yon can specify a window size modifier for Behat, which is applied to any window szie changes.
923 // For example, if a window size of 640x768 is specified, with a modifier of 2, then the final size is 1280x1536.
924 // This is particularly useful for behat reruns to eliminate issues with window sizing.
925 // Example:
926 // $CFG->behat_window_size_modifier = 1;
928 // Including feature files from directories outside the dirroot is possible if required. The setting
929 // requires that the running user has executable permissions on all parent directories in the paths.
930 // Example:
931 // $CFG->behat_additionalfeatures = array('/home/developer/code/wipfeatures');
933 // You can make behat save several dumps when a scenario fails. The dumps currently saved are:
934 // * a dump of the DOM in it's state at the time of failure; and
935 // * a screenshot (JavaScript is required for the screenshot functionality, so not all browsers support this option)
936 // Example:
937 // $CFG->behat_faildump_path = '/my/path/to/save/failure/dumps';
939 // You can make behat pause upon failure to help you diagnose and debug problems with your tests.
941 // $CFG->behat_pause_on_fail = true;
943 // You can specify db, selenium wd_host etc. for behat parallel run by setting following variable.
944 // Example:
945 // $CFG->behat_parallel_run = array (
946 // array (
947 // 'dbtype' => 'mysqli',
948 // 'dblibrary' => 'native',
949 // 'dbhost' => 'localhost',
950 // 'dbname' => 'moodletest',
951 // 'dbuser' => 'moodle',
952 // 'dbpass' => 'moodle',
953 // 'behat_prefix' => 'mdl_',
954 // 'wd_host' => 'http://127.0.0.1:4444/wd/hub',
955 // 'behat_wwwroot' => 'http://127.0.0.1/moodle',
956 // 'behat_dataroot' => '/home/example/bht_moodledata'
957 // ),
958 // );
960 // To change name of behat parallel run site, define BEHAT_PARALLEL_SITE_NAME and parallel run sites will be suffixed
961 // with this value
962 // Example:
963 // define('BEHAT_PARALLEL_SITE_NAME', 'behatparallelsite');
965 // Command line output for parallel behat install is limited to 80 chars, if you are installing more then 4 sites and
966 // want to expand output to more then 80 chars, then define BEHAT_MAX_CMD_LINE_OUTPUT
967 // Example:
968 // define('BEHAT_MAX_CMD_LINE_OUTPUT', 120);
970 // Behat feature files will be distributed randomly between the processes by default. If you have timing file or want
971 // to create timing file then define BEHAT_FEATURE_TIMING_FILE with path to timing file. It will be updated for each
972 // run with latest time taken to execute feature.
973 // Example:
974 // define('BEHAT_FEATURE_TIMING_FILE', '/PATH_TO_TIMING_FILE/timing.json');
976 // If you don't have timing file and want some stable distribution of features, then you can use step counts to
977 // distribute the features. You can generate step file by executing php admin/tool/behat/cli/util.php --updatesteps
978 // this will update step file which is defined by BEHAT_FEATURE_STEP_FILE.
979 // Example:
980 // define('BEHAT_FEATURE_STEP_FILE', '/PATH_TO_FEATURE_STEP_COUNT_FILE/stepcount.json');
982 // Feature distribution for each process is displayed as histogram. you can disable it by setting
983 // BEHAT_DISABLE_HISTOGRAM
984 // Example:
985 // define('BEHAT_DISABLE_HISTOGRAM', true);
987 // Mobile app Behat testing requires this option, pointing to a developer Moodle app directory:
988 // $CFG->behat_ionic_dirroot = '/where/I/keep/my/git/checkouts/moodleapp';
990 // The following option can be used to indicate a running Ionic server (otherwise Behat will start
991 // one automatically for each test run, which is convenient but takes ages):
992 // $CFG->behat_ionic_wwwroot = 'http://localhost:8100';
994 //=========================================================================
995 // 12. DEVELOPER DATA GENERATOR
996 //=========================================================================
998 // The developer data generator tool is intended to be used only in development or testing sites and
999 // it's usage in production environments is not recommended; if it is used to create JMeter test plans
1000 // is even less recommended as JMeter needs to log in as site course users. JMeter needs to know the
1001 // users passwords but would be dangerous to have a default password as everybody would know it, which would
1002 // be specially dangerouse if somebody uses this tool in a production site, so in order to prevent unintended
1003 // uses of the tool and undesired accesses as well, is compulsory to set a password for the users
1004 // generated by this tool, but only in case you want to generate a JMeter test. The value should be a string.
1005 // Example:
1006 // $CFG->tool_generator_users_password = 'examplepassword';
1008 //=========================================================================
1009 // 13. SYSTEM PATHS (You need to set following, depending on your system)
1010 //=========================================================================
1011 // Ghostscript path.
1012 // On most Linux installs, this can be left as '/usr/bin/gs'.
1013 // On Windows it will be something like 'c:\gs\bin\gswin32c.exe' (make sure
1014 // there are no spaces in the path - if necessary copy the files 'gswin32c.exe'
1015 // and 'gsdll32.dll' to a new folder without a space in the path)
1016 // $CFG->pathtogs = '/usr/bin/gs';
1018 // Path to PHP CLI.
1019 // Probably something like /usr/bin/php. If you enter this, cron scripts can be
1020 // executed from admin web interface.
1021 // $CFG->pathtophp = '';
1023 // Path to du.
1024 // Probably something like /usr/bin/du. If you enter this, pages that display
1025 // directory contents will run much faster for directories with a lot of files.
1026 // $CFG->pathtodu = '';
1028 // Path to aspell.
1029 // To use spell-checking within the editor, you MUST have aspell 0.50 or later
1030 // installed on your server, and you must specify the correct path to access the
1031 // aspell binary. On Unix/Linux systems, this path is usually /usr/bin/aspell,
1032 // but it might be something else.
1033 // $CFG->aspellpath = '';
1035 // Path to dot.
1036 // Probably something like /usr/bin/dot. To be able to generate graphics from
1037 // DOT files, you must have installed the dot executable and point to it here.
1038 // Note that, for now, this only used by the profiling features
1039 // (Development->Profiling) built into Moodle.
1040 // $CFG->pathtodot = '';
1042 // Path to unoconv.
1043 // Probably something like /usr/bin/unoconv. Used as a fallback to convert between document formats.
1044 // Unoconv is used convert between file formats supported by LibreOffice.
1045 // Use a recent version of unoconv ( >= 0.7 ), older versions have trouble running from a webserver.
1046 // $CFG->pathtounoconv = '';
1048 //=========================================================================
1049 // 14. ALTERNATIVE FILE SYSTEM SETTINGS
1050 //=========================================================================
1052 // Alternative file system.
1053 // Since 3.3 it is possible to override file_storage and file_system API and use alternative storage systems (e.g. S3,
1054 // Rackspace Cloud Files, Google Cloud Storage, Azure Storage, etc.).
1055 // To set the alternative file storage system in config.php you can use the following setting, providing the
1056 // alternative system class name that will be auto-loaded by file_storage API.
1058 // $CFG->alternative_file_system_class = '\\local_myfilestorage\\file_system';
1060 //=========================================================================
1061 // 15. CAMPAIGN CONTENT
1062 //=========================================================================
1064 // We have added a campaign content to the notifications page, in case you want to hide that from your site you just
1065 // need to set showcampaigncontent setting to false.
1067 // $CFG->showcampaigncontent = true;
1069 //=========================================================================
1070 // ALL DONE! To continue installation, visit your main page with a browser
1071 //=========================================================================
1073 require_once(__DIR__ . '/lib/setup.php'); // Do not edit
1075 // There is no php closing tag in this file,
1076 // it is intentional because it prevents trailing whitespace problems!