====== Paramètres du fichier de configuration (JcDenis : fini) ====== ===== 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’[[.:install#assistant-d-installation|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 === //(Obligatoire)// Type de base de données utilisée par Dotclear. Vous pouvez indiquer les valeurs suivantes : * ''mysql'' : MySQL ( Obsolète à partir PHP 5.5 ) * ''mysqli'' : MySQL ( Recommandé, requiert MySQL >= 4.1 ) * ''pgsql'' : PostgreSQL * ''sqlite'' : SQLite === DC_DBHOST === //(Obligatoire)// 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''. Exemple : * ''localhost'' * ''autre.exemple.net:3066'' === DC_DBUSER === //(Obligatoire)// Nom d’utilisateur de la base de données. === DC_DBPASSWORD === //(Obligatoire)// Mot de passe de l’utilisateur de la base de données. === DC_DBNAME === //(Obligatoire)// 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 === //(Obligatoire)// 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_''. Ceci permet d'utiliser la même base de données pour plusieurs programmes. === DC_DBPERSIST === //(Obligatoire)// 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 === //(Obligatoire)// Ce paramètre est une chaîne de caractères contenant la clé privée permettant de chiffrer 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 === //(Obligatoire)// 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/'); Vous trouverez [[.:clean-install#et-l-administration-dans-tout-ca|ici]] des indications pour rendre accessible l'interface d'administration depuis une autre adresse. === DC_ADMIN_MAILFROM === //(Obligatoire)// Adresse mél à utiliser comme émetteur des mails de récupération de mot de passe. === DC_SESSION_NAME === //(Obligatoire)// 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 === //(Obligatoire)// 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 si un même plugin est présent dans deux répertoires, alors celui du dernier répertoire sera utilisé. De même, lors de l'installation d'un plugin depuis l'interface d'administration de Dotclear, ce plugin sera installé dans le dernier répertoire. Vous pouvez par exemple utiliser 3 répertoires, le premier nommé ''plugin'' sera celui des plugins fournis avec Dotclear, le second nommé ''mes-plugins'' sera consacré à vos plugins personnels, et le troisième nommé ''autres-plugins'' sera utilisé pour les plugins installés depuis l'interface d'administration de Dotclear. === DC_TPL_CACHE === //(Obligatoire)// Ce paramètre indique le chemin du répertoire de cache de Dotclear. Il est utilisé pour stocker temporairement des informations nécessaires au fonctionnement de Dotclear. Vous trouverez [[.:install#installation-classique|ici]] des indications sur le réglage des permissions des dossiers de Dotclear. ==== Paramètres avancés ==== === DC_ADMIN_SSL === //(Optionnel)// 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 === //(Optionnel)// 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 === //(Optionnel)// 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 : 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'); Pour en savoir plus sur l'interface XML_RPC de Dotclear rendez-vous [[..:resources:xml-rpc|ici]]. === HTTP_PROXY_HOST et HTTP_PROXY_PORT === //(Optionnel)// 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. === DC_ERROR_FILE === //(Optionnel)// Permet de spécifier le ficher qui servira à afficher les erreurs d’exécution de Dotclear telles que des problèmes de connexion à la base de donnée, d'identification d'un blog... Par défaut le fichier **inc/core_error.php** sera utilisé. === DC_VENDOR_NAME === //(Optionnel)// Par défaut le nom de vendeur sera ''Dotclear''. ==== Paramètres spécifiques ==== Ces paramètres peuvent être utiles pour les développeurs de plugins et thèmes. === DC_UPDATE_VERSION === //(Optionnel)// Ceci va indiquer à Dotclear quelle version doit vous être proposée à la mise à jour. La valeur de ce paramètre est ''stable'' par défaut. Vous pouvez indiquer une des valeurs suivantes : * ''stable'' : Dernière version stable. * ''testing'' : Mises à jour intermédiaires en cours de test * ''unstable'' : Tous derniers développements des futurs versions (instable) === DC_DEBUG === //(Optionnel)// Ceci est le mode de débogage de Dotclear. Si sa valeur est à ''true'', il relève le niveau d'erreurs affichées. Il ne faut pas utiliser ce mode sur une installation de production. === DC_DEV === //(Optionnel)// Ceci est également un mode de débogage. Si sa valeur est à ''true'', il génère des fichiers journaux (logs) spécifiques et permet l'accès des consoles X-debug. Ce mode ouvre également des menus supplémentaire dans l'interface d'administration des blogs pour les super-administrateurs. ==== Paramètres de certains plugins ==== === DC_ANTISPAM_CONF_SUPER === //(Optionnel)// 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 === //(Optionnel)// Ce paramètre, s’il vaut ''true'' n’autorise la configuration du filtre Akismet que par un super-administrateur. === DC_DNSBL_SUPER === //(Optionnel)// Ce paramètre, s’il vaut ''true'' n’autorise la configuration du filtre DNSBL que par un super-administrateur. === DC_FAIRTRACKBACKS_FORCE === //(Optionnel)// 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]].