Base de registre - Historique des versions

Laucho : /* Récupération d'une valeur */

2018-08-27T08:37:49Z

‎Récupération d'une valeur

Laucho : /* Récupération d'une valeur */

2018-08-20T15:09:07Z

‎Récupération d'une valeur

Laucho : /* API php */

2018-08-20T15:07:20Z

‎API php

Jeraiz : /* $instance->setKeyValue($key, $value) */

2009-06-11T14:33:32Z

‎$instance->setKeyValue($key, $value)

Jeraiz : /* $instance->changeDirectory($dir) */

2009-06-11T14:30:23Z

‎$instance->changeDirectory($dir)

Paul : /* API php */

2009-04-22T12:55:38Z

‎API php

Paul : /* API php */

2009-01-16T10:09:06Z

‎API php

Paul : /* $instance->getValue($key) */

2009-01-16T10:08:33Z

‎$instance->getValue($key)

Paul : /* Module regedit */

2008-12-04T17:09:31Z

‎Module regedit

Paul le 11 avril 2008 à 14:49

2008-04-11T14:49:27Z

@@ Ligne 30 : / Ligne 30 : @@
 et si aucune valeur n'a été enregistrée dans la registry, bab_Registry::get('/myAddon/myValue') renverra la valeur 1234.
-Il est également possible (depuis ovidentia 8.7) de '''forcer''' des valeurs de la registry en définissant cette fois-ci une constante dont le nom sera le valeur path de la registry précédée d'un ! (point d'exclamation). Ainsi en ajoutant dans config.php la ligne suivante :
+=== Modification/définition temporaire d'une valeur via php ===
- define(''''!'''/myAddon/myValue', 1234);
+Un addon a la possibilité de modifier temporairement une valeur de configuration en utilisant la méthode :
-quelle que soit la valeur enregistrée dans la registry, bab_Registry::get('/myAddon/myValue') renverra la valeur 1234.
+ bab_Registry::override($path, $value);
 === Enregistrement d'une valeur ===

@@ Ligne 30 : / Ligne 30 : @@
 et si aucune valeur n'a été enregistrée dans la registry, bab_Registry::get('/myAddon/myValue') renverra la valeur 1234.
-Il est également possible de '''forcer''' des valeurs de la registry en définissant cette fois-ci une constante dont le nom sera le valeur path de la registry précédée d'un ! (point d'exclamation). Ainsi en ajoutant dans config.php la ligne suivante :
+Il est également possible (depuis ovidentia 8.7) de '''forcer''' des valeurs de la registry en définissant cette fois-ci une constante dont le nom sera le valeur path de la registry précédée d'un ! (point d'exclamation). Ainsi en ajoutant dans config.php la ligne suivante :
   define(''''!'''/myAddon/myValue', 1234);

← Version précédente		Version du 20 août 2018 à 15:07
Ligne 11 :		Ligne 11 :

	un répertoire par module peut être créé		un répertoire par module peut être créé
		+
		+	== API simplifiée ==
		+
		+	=== Récupération d'une valeur ===
		+	''Depuis ovidentia 8.6''
		+
		+	Il est possible de récupérer une valeur de configuration par l'appel à la méthode :
		+
		+	bab_Registry::get($path, $defaultValue);
		+
		+	'''$path''' est une chaine contenant le chemin complet de la clé, par convention le premier niveau étant le nom de l'addon ayant défini cette clé. Par exemple '/myAddon/myValue'.
		+
		+	Il est possible de configurer les valeurs par défaut remontées par bab_Registry::get() en définissant des constantes de configuration.
		+	Le nom de la constante doit être la valeur path de la registry. Par exemple en ajoutant dans config.php la ligne suivante :
		+
		+	define('/myAddon/myValue', 1234);
		+
		+	et si aucune valeur n'a été enregistrée dans la registry, bab_Registry::get('/myAddon/myValue') renverra la valeur 1234.
		+
		+	Il est également possible de '''forcer''' des valeurs de la registry en définissant cette fois-ci une constante dont le nom sera le valeur path de la registry précédée d'un ! (point d'exclamation). Ainsi en ajoutant dans config.php la ligne suivante :
		+
		+	define(''''!'''/myAddon/myValue', 1234);
		+
		+	quelle que soit la valeur enregistrée dans la registry, bab_Registry::get('/myAddon/myValue') renverra la valeur 1234.
		+
		+	=== Enregistrement d'une valeur ===
		+	''Depuis ovidentia 8.7''
		+
		+	bab_Registry::set($path, $value);
		+
		+	=== Suppression d'une valeur ===
		+	''Depuis ovidentia 8.7''
		+
		+	bab_Registry::delete($path);
		+
		+

	== API php ==		== API php ==

← Version précédente		Version du 11 juin 2009 à 14:33
Ligne 37 :		Ligne 37 :

	<code>$key</code> ne doit pas contenir de '''/'''		<code>$key</code> ne doit pas contenir de '''/'''
		+
		+	Remarque : la clé sera systématiquement créée dans le répertoire sélectionné auparavant (méthode changeDirectory()). Si le répertoire n'existe pas, la base de registre le créera.

	=== $instance->removeKey($key) ===		=== $instance->removeKey($key) ===

@@ Ligne 28 : / Ligne 28 : @@
 === $instance->changeDirectory($dir) ===
-Cette méthode permet de se déplacer dans l'arborescence de la base de registre, <code>$dir</code> est une chaîne de caractères
+Cette méthode permet de se déplacer dans l'arborescence de la base de registre, <code>$dir</code> est une chaîne de caractères.
 === $instance->setKeyValue($key, $value) ===

@@ Ligne 14 : / Ligne 14 : @@
 == API php ==
-La fonction bab_getRegistryInstance est disponible dans tout ovidentia (fichier addonapi.php), elle permet d'obtenir l'instance de l'objet pour utiliser la base de registre.
+La fonction <code>bab_getRegistryInstance</code> est disponible dans tout ovidentia (fichier addonapi.php), elle permet d'obtenir l'instance de l'objet pour utiliser la base de registre.
 exemple :
@@ Ligne 22 : / Ligne 22 : @@
 </source>
-$instance est un objet bab_registry
+$instance est un objet <code>bab_registry</code>
@@ Ligne 28 : / Ligne 28 : @@
 === $instance->changeDirectory($dir) ===
-Cette méthode permet de se déplacer dans l'arborescence de la base de registre, $dir est une chaîne de caractères
+Cette méthode permet de se déplacer dans l'arborescence de la base de registre, <code>$dir</code> est une chaîne de caractères
 === $instance->setKeyValue($key, $value) ===
-Méthode utilisée pour créer une clef et une valeur, $key est une chaîne, et $value peut être un objet, un tableau, une chaîne, un nombre entier ou un nombre flottant.
+Méthode utilisée pour créer une clef et une valeur, <code>$key</code> est une chaîne, et $value peut être un objet, un tableau, une chaîne, un nombre entier ou un nombre flottant.
-$key ne doit pas contenir de /
+<code>$key</code> ne doit pas contenir de '''/'''
 === $instance->removeKey($key) ===
-Méthode pour supprimer une clef
+Méthode pour supprimer une clef et sa valeur
 === $instance->getValue($key, $default_create = null) ===
-Cette méthode permet d'obtenir une valeur enregistrée ou NULL si la clef n'existe pas, la valeur obtenue sera du même type que celle qui a été enregistrée.
+Cette méthode permet d'obtenir une valeur enregistrée ou <code>NULL</code> si la clef n'existe pas, la valeur obtenue sera du même type que celle qui a été enregistrée.
 Si le deuxième paramètre et renseigné et que la valeur n'existe pas, c'est le deuxième paramètre qui sera utilisé comme valeur. la méthode retournera cette valeur et la clef sera crée dans la base de registre avec cette valeur.
@@ Ligne 48 : / Ligne 48 : @@
 === $instance->getValueEx($key) ===
-Cette méthode retourne un tableau avec des informations complémentaires sur la clef
+Cette méthode retourne un tableau avec des informations complémentaires sur la clef.
 === $instance->deleteDirectory() ===

@@ Ligne 18 : / Ligne 18 : @@
 exemple :
-<pre>
+<source lang="php">
 $instance = bab_getRegistryInstance();
-</pre>
+</source>
 $instance est un objet bab_registry
@@ Ligne 61 : / Ligne 61 : @@
 Permet de parcourir les clefs enfants, la méthode retourne la clef suivante
 == Module regedit ==
 le module regedit est en cours de développement (il est présent dans le CVS ovidentia)

← Version précédente		Version du 4 décembre 2008 à 17:09
Ligne 63 :		Ligne 63 :
	== Module regedit ==		== Module regedit ==

−	le module regedit est en cours de développement (il n'est ~~pas disponible en téléchargement~~)	+	le module regedit est en cours de développement (il est présent dans le CVS ovidentia)

← Version précédente		Version du 11 avril 2008 à 14:49
Ligne 1 :		Ligne 1 :
		+	[[Catégorie:Développement de modules]]
		+	[[Catégorie:API Ovidentia]]
		+
	== Structure de la base de registre ==		== Structure de la base de registre ==