====== 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 :

<code php>
define('NOM_PARAMETRE','valeur');
</code>

==== 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 :

<code php>
define('DC_ADMIN_URL','http://monsite/dotclear/admin/');
</code>

<note tip>
Vous trouverez [[.:clean-install#et-l-administration-dans-tout-ca|ici]] des indications pour rendre accessible l'interface d'administration depuis une autre adresse.
</note>

=== 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 :

<code php>
define('DC_PLUGINS_ROOT',dirname(__FILE__).'/../plugins'.PATH_SEPARATOR.dirname(__FILE__).'/../../mes-plugins');
</code>

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'' où ''%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 :

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

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

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

=== 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 à : [[.:install:custom-sendmail|Personnaliser l’envoi des mails]].