Configuration file

Revision as of 18:41, 19 February 2009 by Simnandez (talk | contribs) (New page: {{TemplateDocDevEn}} {{ToTranslate}} Le fichier de configuration de Dolibarr est '''conf/conf.php'''. Il est écrit par la procédure d'installation automatisée. Le contenu du fichier st...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

En verysmall.png Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
It verysmall.png Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Pt verysmall.png Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
De verysmall.png Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
Zh verysmall.png 页面等待翻译。若要翻译本页,先创建一个帐户、登录并返回本页后单击“编辑”。

Le fichier de configuration de Dolibarr est conf/conf.php. Il est écrit par la procédure d'installation automatisée. 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_name="dolibarr";
    $dolibarr_main_db_user="dolibarr";
    $dolibarr_main_db_pass="";

Dolibarr fournit un fichier conf modèle nommé conf/conf.php.example où chaque paramètre est commenté.

Ce fichier ne doit pas jamais être ni modifié, ni lu directement, 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.

Le contenu de ce fichier est accessible au développement à 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:

  1. $dolibarr_main_document_root est connu dans le code grâce à la constante: DOL_DOCUMENT_ROOT
  2. $dolibarr_main_url_root est connu dans le code grâce à la constante: DOL_URL_ROOT
  3. $dolibarr_main_db_type est accessible par $conf->db->type
  4. $dolibarr_main_db_host est accessible par $conf->db->host
  5. $dolibarr_main_db_name est accessible par $conf->db->name
  6. $dolibarr_main_db_user est accessible par $conf->db->login
  7. $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 objets sont disponibles après insertion de l'include de master.inc.php dans son code. Voir les tutoriaux sur le développements de modules Dolibarr pour plus d'information.