Ci-dessous, les différences entre deux révisions de la page.
Prochaine révision | Révision précédente | ||
devguide:begin:devconfig [2012/01/06 16:26] jmr créée |
devguide:begin:devconfig [2017/01/19 14:54] (Version actuelle) |
||
---|---|---|---|
Ligne 6: | Ligne 6: | ||
* ... | * ... | ||
+ | ===== Le mode développement et la compilation de fichiers ===== | ||
+ | Dans un souci de performance, Change n’analyse pas directement les différents fichiers de configuration (en général des fichiers XML) : ces fichiers sont transformés en fichiers directement interprétés par le moteur PHP lors d’une phase dite de « //compilation// », matérialisée par une ou plusieurs commandes Change (Les commandes de compilation commencent toutes par « //compile-// »). | ||
+ | |||
+ | Remarques : | ||
+ | * La commande ''change.php compile-all'' permet de compiler les différents fichiers en une passe et dans le bon ordre. | ||
+ | * Les fichiers compilés sont placés dans le dossier ''build/''. | ||
+ | |||
+ | Le mode développement simplifie l’activité du développeur en prenant en charge certaines compilations ou mises à jour de fichiers de cache (styles CSS ou Javascript notamment). | ||
+ | |||
+ | **Important :** le mode développement n’est pas prévu pour la mise en production. En plus des performances amoindries, certaines parties ne sont absolument pas « thread-safe ». | ||
===== Activer le mode développement ===== | ===== Activer le mode développement ===== | ||
+ | <note important>A partir de la version 3.5</note> | ||
+ | Dans le fichier //change.properties// : | ||
+ | <sxh bash> | ||
+ | #Developpment Mode | ||
+ | DEVELOPMENT_MODE=true | ||
+ | </sxh> | ||
+ | |||
<note important>Pour les versions < 3.5</note> | <note important>Pour les versions < 3.5</note> | ||
Dans le fichier //config/project.<profile>.xml// : | Dans le fichier //config/project.<profile>.xml// : | ||
Ligne 17: | Ligne 34: | ||
<define name="AG_DEVELOPMENT_MODE">true</define> | <define name="AG_DEVELOPMENT_MODE">true</define> | ||
... | ... | ||
- | </sxh> | ||
- | |||
- | <note important>A partir de la version 3.5</note> | ||
- | Dans le fichier //change.properties// : | ||
- | <sxh bash> | ||
- | #Developpment Mode | ||
- | DEVELOPMENT_MODE=false | ||
</sxh> | </sxh> | ||
Ligne 51: | Ligne 61: | ||
Il est également possible de modifier la verbosité des logs via le fichier //project.<profile>.xml//. Les niveaux de log autorisés sont : | Il est également possible de modifier la verbosité des logs via le fichier //project.<profile>.xml//. Les niveaux de log autorisés sont : | ||
* DEBUG | * DEBUG | ||
- | * ERROR | + | * INFO |
- | * INFO | + | |
* WARN | * WARN | ||
+ | * ERROR | ||
* FATAL | * FATAL | ||
+ | |||
+ | <note tip>Pour le développement, nous recommandons le niveau INFO et si l'on souhaite débugger les requêtes SQL passer le niveau en DEBUG. | ||
+ | \\ A l'inverse, en production, préférer WARN ou ERROR.</note> | ||
<sxh xml;highlight: 4> | <sxh xml;highlight: 4> | ||
Ligne 60: | Ligne 73: | ||
<project> | <project> | ||
<defines> | <defines> | ||
- | <define name="AG_LOGGING_LEVEL">DEBUG</define> | + | <define name="AG_LOGGING_LEVEL">INFO</define> |
... | ... | ||
</sxh> | </sxh> | ||
+ | ===== Prise en compte des modifications de la configuration ===== | ||
+ | A chaque modification de la configuration vous devez recompiler la configuration : | ||
+ | <sxh bash;highlight:1> | ||
+ | php framework/bin/change.php compile-config | ||
+ | == Compile config == | ||
+ | => Config compiled | ||
+ | </sxh> | ||
+ | Si vous avez également modifié le fichier ''change.properties'', préférez : | ||
+ | <sxh bash;highlight:1> | ||
+ | php framework/bin/change.php compile-config --clear | ||
+ | == Compile config == | ||
+ | => Config compiled | ||
+ | </sxh> |