khosb/includes/kohana/modules/userguide/guide/fr-fr/about.configuration.md

Configuration Générale

[!!] todo, description of benefits of static properties for configuration

Configuration du noyau

La toute première configuration à modifier lors d'une installation de kohana est de changer les paramètres d'initlalisation [Kohana::init] dans le fichier application/bootstrap.php. Ces paramètres sont:

boolean errors

Utilisation de la gestion des erreurs et des exceptions? (Défaut TRUE) Affecter à FALSE pour désactiver la gestion des erreurs et exceptions.

boolean profile

Activer le benchmarking interne? (Défault TRUE) Affecter à FALSE pour désactiver le benchmarking interne. A desactiver en production pour obtenir de meilleures performances.

boolean caching

Mettre en cache les chemins des fichiers entre les requêtes? (Défault FALSE) Affecter à TRUE pour mettre en cache les chemins absolus. Ceci peut améliorer drastiquement les performances de la méthode [Kohana::find_file].

string charset

Jeu de caractères à utiliser pour toutes les entrées et sorties. (Défault "utf-8") Affecter un jeu de caractères supporté aussi bien par htmlspecialchars que iconv.

string base_url

URL racine de l'application. (Défault "/") Peut être une URL complète ou partielle. Par exemple "http://example.com/kohana/" ou "/kohana/" fonctionneraient.

string index_file

Le fichier PHP qui démarre l'application. (Défault "index.php") Affecter à FALSE pour enlever le fichier index de l'URL en utilisant l'URL Rewriting.

string cache_dir

Répertoire de stockage du cache. (Défault "application/cache") Doit pointer vers un répertoire inscriptible.

Paramètres des Cookies

Il y a plusieurs propriétés statiques dans la classe [Cookie] qui doivent être paramétrées, particuliérement sur les sites en production.

string salt

La chaîne d'aléa (salt) unique utilisée pour signer les cookies

integer expiration

La durée d'expiration par défaut

string path

Restreindre l'accès aux cookies par rapport au chemin spécifié

string domain

Restreindre l'accès aux cookies par rapport au domaine spécifié

boolean secure

N'autoriser les cookies qu'en HTTPS

boolean httponly

N'autorise l'accès aux cookies que via HTTP (désactive aussi l'accès javascript)

Fichiers de configuration

La configuration de Kohana est faite dans des fichiers à plat PHP, qui ressemblent à l'exemple ci-dessous:

<?php defined('SYSPATH') or die('No direct script access.');

return array(
    'setting' => 'value',
    'options' => array(
        'foo' => 'bar',
    ),
);

Supposons que le fichier ci-dessus soit appelé myconf.php, il est alors possible d'y accèder de la manière suivante:

$config = Kohana::config('myconf');
$options = $config['options'];

[Kohana::config] fournit aussi un raccourci pour accèder à des clés spécifiques des tableaux de configuration en utilisant des chemins spérarés par le caractère point.

Récupérer le tableau "options":

$options = Kohana::config('myconf.options');

Récupérer la valeur de la clé "foo" du tableau "options":

$foo = Kohana::config('myconf.options.foo');

Les tableaux de configuration peuvent aussi être parcourus comme des objets comme suit:

$options = Kohana::config('myconf')->options;