What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Les fichiers de configuration sont un moyen interressant pour gérer des variables depuis un seul et même fichier. L'exemple le plus courant étant le schéma de couleurs du template. Normalement, pour changer le schéma de couleur d'une application, vous devriez aller dans chaque template et changer la couleur des éléments (ou les classes css). Avec un fichier de configuration, il vous est possible de conserver la couleur dans un seul endroit, puis de la mettre à jour une seule fois.
Example 9.1. Exemple de fichier de configuration
# variables globales titrePage = "Menu principal" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 [client] titrePage = "Infos client" [Login] titrePage = "Login" focus = "utilisateur" Intro = """Une valeur qui tient sur plusieur lignes. Vous devez la placer entre trois guillemets.""" # hidden section [.Database] host=mon.example.com db=ADDRESSBOOK user=php-user pass=foobar
Les valeurs des variables de fichiers de configuration
peuvent être entre guillemets, sans que celà soit nécessaire. Si vous vouler utiliser des
valeurs sur plusieurs lignes, vous devrez les entourer de triples
guillemets ("""). Vous pouvez insérer des commentaires dans les fichiers de
configuration en utilisant une syntaxe quelquonque, non valide.
Nous recommandons l'utilisation de #
(dièse) en début
de ligne.
Cet exemple de fichier de configuration contient deux sections. Les noms des
sections sont entourés de crochets []. Les noms de section peuvent être
des chaînes, ne contenant aucun des symboles [
et
]
. Dans notre exemple, les 4 variables du début sont
des variables dites globales, qui ne sont pas contenue dans une section.
Ces variables sont toujours chargées depuis le fichier de configuration.
Si une section est chargée, alors toutes les variables de cette section
ainsi que les variables globales sont chargées. Si une variable existe
à la fois en tant que globale et à la fois en tant que variable de
section, la variable de section est prioritaire.
Si vous appelez deux variables dans une même section de la même façon,
la dernière déclarée prime. (voir
$config_overwrite
)
Les fichiers de configuration sont chargés dans le template grâce aux
fonctions {config_load}
(voir aussi config_load()
).
Vous pouvez masquer des variables ou des sections entières en préfixant le nom de la variable ou le nom de la section avec une virgule. Ce procédé est utile si votre application récupère ses données depuis plusieurs fichiers de configuration et récupère des données sensibles dont vos templates n'ont pas besoin. Si des tiers éditent des templates, vous êtes sûr que ces derniers n'accèderont pas à ces données de configuration en les chargeant depuis le template.
Voir aussi
{config_load}
,
$config_overwrite
,
get_config_vars()
,
clear_config()
et
config_load()
.