Configuration de l'application

Auparavant il fallait chercher les différentes ressources de configuration de Dotclear un peu partout, dans les fichier index, dans le fichier de config, dans des constantes, etc. Depuis la version 2.28, toutes ces informations sont accessibles depuis une seule classe et ses méthodes. Cette classe n'est pas modifiable, n'est pas remplaçable, aucune de ses propriétés n'est accessible. Elle va récupérer toutes les informations, notamment depuis le fichier config.php (qui ne change pas), les traiter et les proposer via ses méthodes avec un typage de retour strict et défini. Elle va également faire les premières vérifications de ces valeurs.
Il n'est plus utile de lire les constantes de Dotclear, toutes les constantes de la version 2.27 existent toujours mais ont leurs méthodes associées en 2.28 dans App::config(), de part ce fait ces valeurs existent toujours et ont un type fixe ce qui facilite leurs utilisations.

Liste des informations disponibles :

• startTime(): float; DC_START_TIME
• cliMode(): bool; CLI_MODE
• debugMode(): bool; DC_DEBUG
• devMode(): bool; DC_DEV
• errorFile(): string; DC_ERRORFILE
• blogId(): string; DC_BLOG_ID
• dotclearRoot(): string; DC_ROOT
• dotclearVersion(): string; DC_VERSION
• dotclearName(): string; DC_NAME
• hasConfig(): bool;
• configPath(): string; DC_RC_PATH
• digestsRoot(): string; DC_DIGESTS
• l10nRoot(): string; DC_L10N_ROOT
• l10nUpdateUrl(): string; DC_L10N_UPDATE_URL
• distributedPlugins(): string; DC_DISTRIB_PLUGINS
• distributedThemes(): string; DC_DISTRIB_THEMES
• defaultTheme(): string; DC_DEFAULT_THEME
• defaultTplset(): string; DC_DEFAULT_TPLSET
• defaultJQuery(): string; DC_DEFAULT_JQUERY
• minRequiredPhp(): string;
• minRequiredMysql(): string;
• minRequiredPgsql(): string;
• nextRequiredPhp(): string; DC_NEXT_REQUIRED_PHP
• vendorName(): string; DC_VENDOR_NAME
• xmlrpcUrl(): string; DC_XMLRPC_URL
• sessionTtl(): ?string; DC_SESSION_TTL
• sessionName(): string; DC_SESSION_NAME
• adminSsl(): bool; DC_ADMIN_SSL
• adminUrl(): string; DC_ADMIN_URL
• adminMailfrom(): string; DC_ADMIN_MAILFROM
• dbDriver(): string; DC_DBDRIVER
• dbHost(): string; DC_DBHOST
• dbUser(): string; DC_DBUSER
• dbPassword(): string; DC_DBPASSWORD
• dbName(): string; DC_DBNAME
• dbPrefix(): string; DC_DBPREFIX
• dbPersist(): bool; DC_DBPERSIST
• masterKey(): string; DC_MASTER_KEY
• cryptAlgo(): string; DC_CRYPT_ALGO
• coreUpdateUrl(): string; DC_UPDATE_URL
• coreUpdateCanal(): string; DC_UPDATE_VERSION
• coreNotUpdate(): bool; DC_NOT_UPDATE
• allowMultiModules(): bool; DC_ALLOW_MULTI_MODULES
• storeNotUpdate(): bool; DC_STORE_NOT_UPDATE
• allowRepositories(): bool; DC_ALLOW_REPOSITORIES
• allowRestServices(): bool; DC_REST_SERVICES
• cacheRoot(): string; DC_TPL_CACHE
• varRoot(): string; DC_VAR
• backupRoot(): string; DC_BACKUP_PATH
• coreUpgrade(): string; DC_UPGRADE
• pluginsRoot(): string; DC_PLUGINS_ROOT
• maxUploadSize(): int; DC_MAX_UPLOAD_SIZE
• queryTimeout(): int; DC_QUERY_TIMEOUT
• showHiddenDirs(): bool; DC_SHOW_HIDDEN_DIRS
• httpScheme443(): bool; DC_FORCE_SCHEME_443
• httpReverseProxy(): bool; DC_REVERSE_PROXY
• checkAddBlocker(): bool; DC_ADBLOCKER_CHECK
• cspReportFile(): string; DC_CSP_LOGFILE

Pour en savoir plus sur la signification de ces méthodes, il est recommandé de lire le contenu du fichier src/Interface/ConfigInterface.php. (Visible sur le dépôt git.)
Pour accéder à une de ces valeurs, il suffit de faire App::config()->cacheRoot();.

Attention

Là où souvent il fallait tester la présence d'une valeur, par exemple :
if (defined('DC_DEFAULT_TPLSET')) { $tpl = DC_DEFAULT_TPLSET; }
Désormais cette valeur existe toujours, on peut éventuellement tester si elle est vide :
if (!empty(App::config()->defaultTplset())) { }.