Configuració¶

MRBS carrega els valors predeterminats des de l'aplicació i, a continuació, aplica substitucions específiques de la instal·lació.

Fitxers de configuració¶

Fitxer	Propòsit	Editar directament?
`config.inc.php`	Configuració i secrets específics del lloc	Sí
`config.inc.php-sample`	Punt de partida per a una configuració nova	Copieu-lo
`systemdefaults.inc.php`	Valors predeterminats documentats de l'aplicació	No
`areadefaults.inc.php`	Valors predeterminats per a les àrees de nova creació	No

Per canviar un paràmetre, copieu l'assignació corresponent del fitxer de valors predeterminats a config.inc.php i modifiqueu-ne el valor.

// Copied from systemdefaults.inc.php and overridden for this site.
$default_view = "week";

No exposeu la configuració

config.inc.php conté credencials de la base de dades i, possiblement, del correu o del proveïdor d'identitat. Restringiu l'accés al fitxer i no incorporeu mai una configuració de producció al repositori.

Configuració mínima¶

Normalment, una nova instal·lació requereix:

$timezone = "Europe/Berlin";

$dbsys = "mysql";
$db_host = "localhost";
$db_database = "mrbs";
$db_login = "mrbs";
$db_password = "replace-this-password";
$db_tbl_prefix = "mrbs_";

Valors predeterminats del sistema i de l'àrea¶

Els valors predeterminats del sistema s'apliquen globalment tret que s'anul·lin. Els valors predeterminats de l'àrea inicialitzen nous registres d'àrea.

Per a les àrees existents, utilitzeu la interfície d'administració. Aquesta és una font habitual de confusió: canviar una àrea per defecte no reescriu els registres de la base de dades existents.

Organitzeu les substitucions locals¶

Mantingueu les substitucions relacionades juntes:

/******************
 * Authentication
 ******************/
$auth["type"] = "db";
$auth["session"] = "php";

/********
 * Email
 ********/
$mail_settings['admin_backend'] = 'smtp';
$smtp_settings['host'] = 'mail.example.org';

Afegiu un motiu breu per a configuracions no òbvies. Eviteu copiar tot el fitxer predeterminat perquè això fa que les actualitzacions futures siguin més difícils de revisar.

Aplicació segura dels canvis¶

Feu una còpia de seguretat de config.inc.php.
Modifiqueu un únic grup de paràmetres relacionats.
Comproveu la sintaxi de PHP:

php -l config.inc.php

Feu proves com a administrador, com a usuari normal i sense iniciar sessió.
Manteniu les credencials fora dels registres, les captures de pantalla i els informes de problemes.

Utilitzeu la referència de configuració per trobar el grup de paràmetres adequat. Per consultar el procés complet de configuració i manteniment, vegeu config.inc.php en profunditat.