Outils pour utilisateurs

Outils du site


Panneau latéral

devguide:begin:devconfig

Configurer RBS Change pour développer

Pour pouvoir développer avec RBS Change, il faut modifier quelques options de configurations pour :

  • bénéficier d'un confort de développement supplémentaire
  • éviter d'envoyer des mails à tout le monde

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

A partir de la version 3.5

Dans le fichier change.properties :
#Developpment Mode
DEVELOPMENT_MODE=true

Pour les versions < 3.5

Dans le fichier config/project.<profile>.xml :
<?xml version="1.0" encoding="utf-8"?>
<project>
	<defines>
		<define name="AG_DEVELOPMENT_MODE">true</define>
		...

Rediriger tous les mails vers une seule adresse

Afin d'éviter d'envoyer des mails à tout le monde à partir de la plate forme de développement, il peut être utile de renvoyer les mails que sur une seule adresse. RBSChange permet de faire ce type de manipulation, via le paramètre de configuration FAKE_EMAIL dans le fichier project.<profile>.xml :

<?xml version="1.0" encoding="utf-8"?>
<project>
	<defines>
		<define name="FAKE_EMAIL">me@home.me</define>
                ...

Désactiver le cache

Quand on travail en développement, parfois il peut être utile de ne pas activer le cache afin de ne pas avoir à le purger pour valider tel ou tel développement. Il est possible de désactiver les caches de RBSChange via les paramètres booléens AG_DISABLE_BLOCK_CACHE AG_DISABLE_SIMPLECACHE du fichier project.<profile>.xml

<?xml version="1.0" encoding="utf-8"?>
<project>
	<defines>
		<define name="AG_DISABLE_BLOCK_CACHE">true</define>
		<define name="AG_DISABLE_SIMPLECACHE">true</define>
        ...

Modifier le niveau de log

Il est également possible de modifier la verbosité des logs via le fichier project.<profile>.xml. Les niveaux de log autorisés sont :

  • DEBUG
  • INFO
  • WARN
  • ERROR
  • FATAL

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.

<?xml version="1.0" encoding="utf-8"?>
<project>
	<defines>
		<define name="AG_LOGGING_LEVEL">INFO</define>
                ...

Prise en compte des modifications de la configuration

A chaque modification de la configuration vous devez recompiler la configuration :

php framework/bin/change.php compile-config
== Compile config ==
=> Config compiled

Si vous avez également modifié le fichier change.properties, préférez :

php framework/bin/change.php compile-config --clear
== Compile config ==
=> Config compiled

devguide/begin/devconfig.txt · Dernière modification: 2017/01/19 14:54 (modification externe)