Paramètres du fichier de configuration

Introduction

Le fichier de configuration de votre installation est le fichier inc/config.php. Celui-ci aura été créé soit à la main, soit par l’assistant d’installation.

Nous allons voir les différentes valeurs qu’il est possible d’y ajouter, ainsi que quelques astuces pouvant s’avérer utiles.

Paramètres

Les paramètres du fichier de configuration sont des constantes. On les définit donc comme ceci :

define('NOM_PARAMETRE','valeur');

Paramètres de la base de données

DC_DBDRIVER

Type de base de données utilisée par Dotclear. Vous pouvez indiquer les valeurs suivantes :

  • mysql : MySQL
  • pgsql : PostgreSQL
  • sqlite : SQLite

DC_DBHOST

Nom d’hôte de la base de données. Notez que vous pouvez ajouter un port en suffixant le nom d’hôte de : :num-port.

DC_DBUSER

Nom d’utilisateur de la base de données.

DC_DBPASSWORD

Mot de passe de l’utilisateur de la base de données.

DC_DBNAME

Nom de la base de données. Dans le cas de SQLite, il s’agit du seul paramètre à indiquer et il contient le chemin vers le fichier de la base de données.

DC_DBPREFIX

Préfixe des tables Dotclear dans la base de données. Si vous indiquez par exemple dc_, les noms de table commenceront tous par dc_.

DC_DBPERSIST

Ce paramètre peut valoir true ou false et indique si les connexions à la base de données doivent être persistantes.

Paramètres généraux

DC_MASTER_KEY

Ce paramètre est une chaîne de caractères contenant la clé privée permettant de chiffre les mots de passe stockés dans la base de données. Ne changez pas ce paramètre si Dotclear est installé, vous ne pourriez plus vous authentifier.

DC_ADMIN_URL

Adresse complète de l’interface d’administration. Cette indication est nécessaire pour le fonctionnement complet de certains plugins. L’adresse doit se terminer par un slash ("/"). Exemple :

define('DC_ADMIN_URL','http://monsite/dotclear/admin/');

Astuce :

Vous trouverez ici des indications pour rendre accessible l'interface d'administration depuis une autre adresse.

DC_ADMIN_MAILFROM

Adresse email à utiliser comme émetteur des mails de récupération de mot de passe.

DC_SESSION_NAME

Nom du cookie de session. Par défaut, il s’agit de dcxd mais vous pouvez le changer par ce que vous voulez.

DC_PLUGINS_ROOT

Ce paramètre indique le chemin d’accès aux plugins. Par défaut, il vaut dirname(__FILE__).'/../plugins' ce qui correspond au répertoire plugins de votre installation. Vous pouvez le changer ou, mieux, en ajouter d’autres. Par exemple :

define('DC_PLUGINS_ROOT',dirname(__FILE__).'/../plugins'.PATH_SEPARATOR.dirname(__FILE__).'/../../mes-plugins');

Ceci indique à Dotclear de chercher les plugins dans le répertoire plugins de Dotclear puis dans un répertoire mes-plugins à côté du dossier contenant Dotclear. Notez que les plugins du dernier répertoire défini remplacent ceux des précédents s’ils ont le même nom (ce qui peut être utile pour changer le comportement d’un plugin par défaut sans l’effacer FIXME).

DC_TPL_CACHE

Ce paramètre indique le chemin du répertoire de cache de Dotclear.

Paramètres avancés

DC_ADMIN_SSL

Ce paramètre prend les valeur true ou false et indique si l’interface d’administration se trouve sur un hôte sécurisé en SSL. Le but principal de ce paramètre est de ne permettre la transmission du cookie de session que dans un contexte sécurisé.

DC_FORCE_SCHEME_443

Si ce paramètre vaut true, le scheme retourné par certaines méthodes de Dotclear pour définir son URL sera toujours https. Ceci ne doit être utilisé que si vous rencontrez des problèmes de redirection ne fonctionnant pas dans l’interface d’administration et si vous avez placé l’interface d’administration sur un hôte SSL.

DC_XMLRPC_URL

Ce paramètre indique le patron de l’adresse de l’interface XML-RPC. Sa valeur par défaut est : %1$sxmlrpc/%2$s%1$s correspond à l’URL du blog et %2$s à l’identifiant du blog.

Dotclear fournit un point d’accès XML-RPC supplémentaire dans le répertoire d’administration. Ceci permet notamment d’autoriser l’accès XML-RPC via un canal sécurisé si l’administration du blog se trouve en SSL.

Vous pouvez ainsi indiquer la valeur suivante :

define('DC_XMLRPC_URL',DC_ADMIN_URL.'xmlrpc.php?b=%2$1s');

ou encore (si votre système/hébergeur supporte le PATH_INFO) :

define('DC_XMLRPC_URL',DC_ADMIN_URL.'xmlrpc/%2$1s');

DC_UPDATE_VERSION

La valeur de ce paramètre est stable par défaut. Vous pouvez indiquer testing si vous souhaitez profiter des mises à jour intermédiaires à tester de Dotclear.

HTTP_PROXY_HOST et HTTP_PROXY_PORT

Si vous souhaitez couper le trafic web de votre serveur vers l’extérieur, ces deux paramètres indiquent respectivement l’hôte et le port du proxy HTTP qui seront utilisés par Dotclear pour accéder à l’extérieur.

Paramètres de certains plugins

DC_ANTISPAM_CONF_SUPER

Ce paramètre, s’il vaut true n’autorise certains aspects de la configuration de l’antispam que par un super-administrateur. (Notamment le temps de conservation du spam).

DC_AKISMET_SUPER

Ce paramètre, s’il vaut true n’autorise la configuration du filtre Akismet que par un super-administrateur.

DC_DNSBL_SUPER

Ce paramètre, s’il vaut true n’autorise la configuration du filtre DNSBL que par un super-administrateur.

DC_FAIRTRACKBACKS_FORCE

Ce paramètre, s’il vaut true force l’utilisation du filtre FairTrackbacks quel que soit le choix de l’utilisateur.

Ajouts au fichier

Le fichier de configuration est un des tous premiers à être appelé. Il est ainsi possible d’y ajouter des éléments dont nous pouvons avoir besoin, en plus de simple constantes.

Fonction mail()

Il est possible de surcharger la fonction utilisée pour envoyer des mails. Par défaut celle-ci utilise le mécanisme standard de php (la fonction mail()). Si vous rencontrez des problèmes avec l’envoi de mails, par exemple si les mails envoyés sont trop fréquemment arrêtés par des filtres antispams, nous vous conseillons de configurer l’envoi de mail. Pour plus d’informations, reportez-vous à : Personnaliser l’envoi des mails.

Wiki powered by Dokuwiki.