Configuration - messagerie-melanie2/Roundcube-Mel GitHub Wiki

Retour doc Webmail

Fichier de configuration

La configuration générale du webmail doit se faire dans le fichier config/config.inc.php
Voir le fichier d'exemple config.inc.php

Configurations indispensables

Voici la liste des champs qu'il faut nécessairement déclarer dans le fichier pour que cela fonctionne

db_dsnw

Ce champ contient la configuration vers la base de données roundcube configuréé initialement

// Database connection string (DSN) for read+write operations
// Format (compatible with PEAR MDB2): db_provider://user:password@host/database
// Currently supported db_providers: mysql, pgsql, sqlite, mssql or sqlsrv
// For examples see http://pear.php.net/manual/en/package.database.mdb2.intro-dsn.php
// NOTE: for SQLite use absolute path: 'sqlite:////full/path/to/sqlite.db?mode=0646'
$config['db_dsnw'] = 'pgsql://roundcube:[email protected]/roundcube';

default_host

Ce champ peut contenir une valeur ou un tableau de valeur pour renseigner le ou les serveurs IMAP auquels Roundcube devra se connecter. Si plusieurs serveurs sont configurés le driver (voir driver) doit permettre de déterminer sur quel serveur IMAP l'utilisateur se connecte.

// The mail host chosen to perform the log-in.
// Leave blank to show a textbox at login, give a list of hosts
// to display a pulldown menu or set one host as string.
// To use SSL/TLS connection, enter hostname with prefix ssl:// or tls://
// Supported replacement variables:
// %n - hostname ($_SERVER['SERVER_NAME'])
// %t - hostname without the first part
// %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part)
// %s - domain name after the '@' from e-mail address provided at login screen
// For example %n = mail.domain.tld, %t = domain.tld

Configuration mono serveur :
$config['default_host'] = 'ssl://web-srv.mce.com';

Configuration multi serveurs :
$config['default_host'] = ['ssl://web-srv1.mce.com','ssl://web-srv2.mce.com','ssl://web-srv3.mce.com'];

En complément un port par défaut peut être configuré

// IMAPS port
#$config['default_port'] = 993;

smtp_server

Configuration du serveur smtp

// SMTP server host (for sending mails).
// To use SSL/TLS connection, enter hostname with prefix ssl:// or tls://
// If left blank, the PHP mail() function is used
// Supported replacement variables:
// %h - user's IMAP hostname
// %n - hostname ($_SERVER['SERVER_NAME'])
// %t - hostname without the first part
// %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part)
// %z - IMAP domain (IMAP hostname without the first part)
// For example %n = mail.domain.tld, %t = domain.tld
$config['smtp_server'] = 'ssl://web-srv.mce.com';

Il y a la possibilité de configurer le port

// SMTP port (default is 25; use 587 for STARTTLS or 465 for the
// deprecated SSL over SMTP (aka SMTPS))
$config['smtp_port'] = 465;

Ainsi que le login/mot de passe pour se connecter au serveur

// SMTP username (if required) if you use %u as the username Roundcube
// will use the current username for login
$config['smtp_user'] = '%u';

// SMTP password (if required) if you use %p as the password Roundcube
// will use the current user's password for login
$config['smtp_pass'] = '%p';

Le driver (voir driver) est également capable de modifier l'utilisateur qui se connecte au serveur smtp (dans le cadre des boites partagées par exemple)

log_dir

Configuration des logs

// use this folder to store log files (must be writeable for apache user)
// This is used by the 'file' log driver.
$config['log_dir'] = '/var/log/roundcube';

des_key

Clé DES utilisé pour chiffrer le mot de passe en session, utiliser une chaine de caractère aléatoire de 24 caractère

// this key is used to encrypt the users imap password which is stored
// in the session record (and the client cookie if remember password is enabled).
// please provide a string of exactly 24 chars.
// YOUR KEY MUST BE DIFFERENT THAN THE SAMPLE VALUE FOR SECURITY REASONS
$config['des_key'] = '6ztWPvSfQ8Pa2SvVBWegduhU';

plugins

Tableau contenant la liste des plugins activés dans le Bnum (pour la liste complète des plugins disponibles, voir plugins du Bnum)

// List of active plugins (in plugins/ directory)
$config['plugins'] = array(
    'mel_courrielleur',
    'mel_commentaire',
    'mel_logs',
    'mel');

skin

Thème a utiliser par défaut, la seul skin compatible avec le Bnum actuellement est mel_elastic

// skin name: folder from skins/
$config['skin'] = 'mel_elastic';

Configurations recommandées

dont_override

Permet de bloquer la modification par l'utilisateur de certaines valeurs de configuration. Par exemple, on recommande de bloquer la modification de skin, du scroll infini, des page size et des dossiers par défaut

// don't allow these settings to be overriden by the user
$config['dont_override'] = array(
    'skin',
    'use_infinite_scroll',
    'preview_pane',
    'addressbook_pagesize',
    'mail_pagesize',
    'drafts_mbox',
    'sent_mbox',
    'junk_mbox',
    'trash_mbox',
);

addressbook_pagesize

La pagination n'était pas nécessaire, renseigner une valeur importante

// show up to X items in contacts list view
$config['addressbook_pagesize'] = 2000;

session_storage

Configuration du type de session à utiliser. A noter qu'une configuration php classique ne sera pas compatible avec des serveurs load balancés en actif/actif. Il faut soit configurer php pour stocker la session sur un cluster Redis ou sur un stockage partagé entre tous les serveurs. Sinon utiliser la configuration memcache ou db.

// Backend to use for session storage. Can either be 'db' (default), 'memcache' or 'php'
// If set to 'memcache', a list of servers need to be specified in 'memcache_hosts'
// Make sure the Memcache extension (http://pecl.php.net/package/memcache) version >= 2.0.0 is installed
// Setting this value to 'php' will use the default session save handler configured in PHP
$config['session_storage'] = 'memcache';

list_cols

Liste des colonnes à afficher par défaut pour les messages

// These cols are shown in the message list. Available cols are: // subject, from, to, fromto, cc, replyto, date, size, status, flag, attachment, 'priority' $config['list_cols'] = array('status', 'fromto', 'subject', 'attachment', 'labels', 'date');

compose_extwin

Ouvrir la rédaction d'un nouveau message dans une nouvelle fenêtre par défaut

// open message compose form in new window
$config['compose_extwin'] = true;

temp_dir

Stockage des fichiers temporaires, dans le cadre de serveurs en actif/actif, privilégier un espace de stockage partagé entre ces serveurs

// use this folder to store temp files (must be writeable for apache user)
$config['temp_dir'] = '/m2/temp';