Fichier de configuration
Le fichier de configuration de Dolibarr est conf/conf.php. Il est écrit par la procédure d'installation automatisée.
Contenu
Le contenu du fichier standard est :
$dolibarr_main_document_root="/home/www/dolibarr/htdocs";
$dolibarr_main_url_root="http://mondomaine.com/dolibarr";
$dolibarr_main_db_type="mysql";
$dolibarr_main_db_host="localhost";
$dolibarr_main_db_port="3306";
$dolibarr_main_db_name="dolibarr";
$dolibarr_main_db_user="dolibarr";
$dolibarr_main_db_pass="";
Autres options :
$dolibarr_main_demo="demologin,demopass"
-> Désactive certaines fonctions pour rendre l'application figée à certains niveaux. Ceci est requis si Dolibarr est en accès comme site de démo à des utilisateurs qui aiment un peu trop faire n'importe quoi.
$dolibarr_main_prod="1"
-> Quand cette option est définie, les messages d'erreurs internes à Dolibarr ne sont plus remontée à l'écran. Cette option est conçue pour les environnements de production afin de ne pas divulguer d'informations aux hackers.
$dolibarr_main_authentication="dolibarr"
-> Permet de changer la manière dont le mot de passe est controlé:
- Il existe différentes valeurs possible qui utilisent toute un mode de validation d'authentification différent ('dolibarr', 'ldap', 'http', ...).
Plus d'information sur les différents modes disponibles sur la page Authentication,_SSO_and_SSL
$dolibarr_allow_download_external_modules=1
-> Permet d'afficher un lien de téléchargement du fichier zip d'un module externe placé dans le dossier custom. Le lien de téléchargement est accessible après avoir cliqué sur l'icone d'aide '?' depuis la liste des modules.
Dolibarr fournit un fichier conf modèle nommé conf/conf.php.example où chaque paramètre est commenté.
Lecture/Ecriture du fichier
Ce fichier ne doit pas jamais être ni lu directement, ni modifié par aucune fonctionnalité de Dolibarr.
Il est créé par la procédure d'installation ou de mise a jour de Dolibarr (install/index.php) qui est la seule habilitée à effectuer des actions sur ce fichier.
Utilisation dans le code
Le contenu de ce fichier est accessible au développeur au travers de constantes ou de l'objet $conf déjà chargés par le code présent dans master.inc.php ou main.inc.php (ces fichiers doivent etre inclus au début de tout programme PHP Dolibarr: master.inc.php pour les scripts et main.inc.php pour les pages). Votre code ne doit jamais ouvrir le fichier de configuration directement. Ce n'est pas nécessaire.
Ainsi:
- $dolibarr_main_data_root est connu dans le code grâce à la constante: DOL_DATA_ROOT (indique l'emplacement physique des fichiers uploadés ou temporaires crées dans Dolibarr)
- $dolibarr_main_document_root est connu dans le code grâce à la constante: DOL_DOCUMENT_ROOT (mais aussi dans le tableau $conf->file->dol_document_root[]. Indique l'emplacement physique des fichiers programmes Dolibarr)
- $dolibarr_main_url_root est connu dans le code grâce à la constante: DOL_URL_ROOT (indique le chemin URL racine de Dolibarr)
- $dolibarr_main_db_type est accessible par $conf->db->type
- $dolibarr_main_db_host est accessible par $conf->db->host
- $dolibarr_main_db_port est accessible par $conf->db->port
- $dolibarr_main_db_name est accessible par $conf->db->name
- $dolibarr_main_db_user est accessible par $conf->db->login
- $dolibarr_main_db_pass n'est pas accessible. Il est lu par master.inc.php (appelé par tout fichier PHP) qui crée un connexion $db puis efface de sa mémoire le mot de passe.
Voir les tutoriaux sur le Développements de modules ou Développement de scripts pour plus d'information.