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é:
- La valeur "dolibarr" s'appuie sur le mot de passe en base de donnée.
- "ldap" permet de se baser sur un annuaire LDAP (dans ce cas il faut renseigner les autres parametres LDAP (vor ficiher conf.php.example).
- "http" utilise l'authentification du protocol HTTP Basic (il est nécesssaire de configurer votre serveur web pour avoir Dolibarr dans une session d'authentification HTTP Basic).
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éveloppement au travers de constantes ou de l'objet $conf créé par le script master.inc.php qui est appelé par tout programme PHP (scripts ou pages).
Ainsi:
- $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[]
- $dolibarr_main_url_root est connu dans le code grâce à la constante: DOL_URL_ROOT
- $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 le script master.inc.php (appelé par tout fichier PHP) qui crée un connexion $db puis efface de sa mémoire le mot de passe.
Normalement, vos développements ne devraient avoir besoin que des constantes DOL_DOCUMENT_ROOT (qui indique le chemin physique du répertoire de stockage de fichiers temporaires ou à conserver) et DOL_URL_ROOT (qui indique le chemin URL vers le répertoire racine de Dolibarr).
D'autres informations et variables déjà initialisées sont disponibles après insertion de l'include de main.inc.php dans son code.
Voir les tutoriaux sur le Développements de modules ou Développement de scripts pour plus d'information.