Développement d'un programme de mise à jour - Historique des versions

Paul : /* Programme de mise à jour d'un module */

2009-06-22T16:17:36Z

‎Programme de mise à jour d'un module

Jeraiz : /* Modification et création des tables */

2009-06-11T15:53:44Z

‎Modification et création des tables

Jeraiz : /* Modification et création des tables */

2009-06-11T15:34:45Z

‎Modification et création des tables

Jeraiz : /* Modification et création des tables */

2009-06-11T14:59:37Z

‎Modification et création des tables

Paul le 6 mai 2009 à 07:36

2009-05-06T07:36:56Z

Paul : /* Modification et création des tables */

2009-05-06T07:35:41Z

‎Modification et création des tables

Paul : /* Programme de mise à jour d'un module */

2009-05-06T07:35:10Z

‎Programme de mise à jour d'un module

Laucho : /* Programme de mise à jour d'un module */

2008-08-29T13:19:10Z

‎Programme de mise à jour d'un module

Laucho le 29 août 2008 à 13:18

2008-08-29T13:18:08Z

Paul : /* bab_setUpgradeLogMsg($addon_name, $message, $uid = '') */

2008-01-15T09:27:38Z

‎<nowiki>bab_setUpgradeLogMsg($addon_name, $message, $uid = '')</nowiki>

← Version précédente		Version du 22 juin 2009 à 16:17
Ligne 64 :		Ligne 64 :

	retourne <code>true</code> si la table n'a pas été modifiée		retourne <code>true</code> si la table n'a pas été modifiée
		+
		+
		+	==== Vérification du traitement ====
		+
		+	la méthode <code>getDifferences()</code>.
		+
		+	Lors du traitement de la synchronisation, une variable tableau est remplie avec les différences trouvées entre la base et le fichier SQL il est possible d'afficher ce tableau afin de s'assurer que le fichier SQL a bien une syntaxe correcte. En effet, le fichier SQL peut contenir des erreur que le serveur MySQL ne remarque pas, le script de synchronisation considère l'erreur comme un changement à effectuer sur la table.
		+
		+	exemple de code pour visualiser les erreurs :
		+
		+	<source lang="php">
		+
		+	bab_debug($tables->getDifferences());
		+	$babBody->babPopup('');
		+
		+	</source>
		+
		+	Dans ce cas, on affiche une popup pour voir les erreurs dans la console de debug, si le message est un tableau vide, c'est qu'il n'y a pas d'erreurs.

	== Outils à utiliser dans le programme de reprise ==		== Outils à utiliser dans le programme de reprise ==

@@ Ligne 14 : / Ligne 14 : @@
 === Modification et création des tables ===
-Il existe dans ovidentia un outil pour créer et mettre a jour des tables à partir d'un fichier SQL.
+Il existe dans Ovidentia un outil pour créer et mettre a jour des tables à partir de requêtes SQL.
-exemple :
+Exemple en utilisant la méthode fromSqlFile pour synchroniser à partir d'un fichier :
 <source lang="php">
 require_once $GLOBALS['babInstallPath'] . 'utilit/devtools.php';
-$tables = new bab_synchronizeSql(dirname(__FILE__) . '/sql/dump.sql');
+$tables = new bab_synchronizeSql();
 </source>
-Dans le fichier SQL, seules les requêtes <code>CREATE TABLE</code> seront traitées, si la table existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES seront executés pour mettre a jour la tables avec le moins de perte de données possibles.
+Dans le fichier SQL, seules les requêtes <code>CREATE TABLE</code> seront traitées, si la table existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES seront executés pour mettre a jour la table avec le moins de perte de données possibles.
-sur l'objet <code>bab_synchronizeSql</code> il existe des méthode pour tester les action effectuées :
+<source lang="php">
 ==== isWorkedTable($table) ====

← Version précédente		Version du 11 juin 2009 à 15:34
Ligne 25 :		Ligne 25 :
	</source>		</source>

−	Dans le fichier SQL, seules les requêtes <code>CREATE TABLE</code> seront traitées, si la table existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES ~~serons~~ executés pour mettre a jour la tables avec le moins de perte de données possibles.	+	Dans le fichier SQL, seules les requêtes <code>CREATE TABLE</code> seront traitées, si la table existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES seront executés pour mettre a jour la tables avec le moins de perte de données possibles.

@@ Ligne 1 : / Ligne 1 : @@
 [[Catégorie:Développement de modules]]
 == Programme de mise à jour du noyau ==
@@ Ligne 26 : / Ligne 25 : @@
 </source>
-Dans le fichier SQL, seul les requêtes <code>CREATE TABLE</code> serons traitées, si la tables existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES serons executés pour mettre a jour la tables avec le moins de perte de donnés possibles.
+Dans le fichier SQL, seules les requêtes <code>CREATE TABLE</code> seront traitées, si la table existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES serons executés pour mettre a jour la tables avec le moins de perte de données possibles.

← Version précédente		Version du 6 mai 2009 à 07:36
Ligne 1 :		Ligne 1 :
		+
		+	[[Catégorie:Développement de modules]]
	== Programme de mise à jour du noyau ==		== Programme de mise à jour du noyau ==

← Version précédente		Version du 6 mai 2009 à 07:35
Ligne 9 :		Ligne 9 :

	Le principe est identique pour les modules, la fonction doit être dans le fichier init.php et s'appeller addon_upgrade($version_base,$version_ini) où addon est le nom du module.		Le principe est identique pour les modules, la fonction doit être dans le fichier init.php et s'appeller addon_upgrade($version_base,$version_ini) où addon est le nom du module.
		+
		+
		+	=== Modification et création des tables ===
		+
		+	Il existe dans ovidentia un outil pour créer et mettre a jour des tables à partir d'un fichier SQL.
		+
		+	exemple :
		+
		+	<source lang="php">
		+
		+	require_once $GLOBALS['babInstallPath'] . 'utilit/devtools.php';
		+	$tables = new bab_synchronizeSql(dirname(__FILE__ . '/sql/dump.sql');
		+
		+	</source>
		+
		+	Dans le fichier SQL, seul les requêtes <code>CREATE TABLE</code> serons traitées, si la tables existe déjà et si les colonnes ne sont pas identiques, des ALTER TABLES serons executés pour mettre a jour la tables avec le moins de perte de donnés possibles.
		+
		+
		+	sur l'objet <code>bab_synchronizeSql</code> il existe des méthode pour tester les action effectuées :
		+
		+	==== isWorkedTable($table) ====
		+
		+	retourne <code>true</code> si la table a été trouvée dans le fichier SQL et vérifiée sur le serveur
		+
		+	==== isCreatedTable($table) ====
		+
		+	retourne <code>true</code> si la table a été crée
		+
		+
		+	==== isModifiedTable($table) ====
		+
		+	retourne <code>true</code> si la table a été modifiée mais pas crée
		+
		+	==== isUnmodifiedTable($table) ====
		+
		+	retourne <code>true</code> si la table n'a pas été modifiée

	== Outils à utiliser dans le programme de reprise ==		== Outils à utiliser dans le programme de reprise ==

@@ Ligne 8 : / Ligne 8 : @@
 == Programme de mise à jour d'un module ==
-le principe est identique pour les module, la fonction doit être dans le fichier init.php et s'appelle addon_upgrade($version_base,$version_ini) où addon est le nom du module.
+Le principe est identique pour les modules, la fonction doit être dans le fichier init.php et s'appeller addon_upgrade($version_base,$version_ini) où addon est le nom du module.
-−
 == Outils à utiliser dans le programme de reprise ==

@@ Ligne 1 : / Ligne 1 : @@
 == Programme de mise à jour du noyau ==
-lors de chaque mise à jour, la fonction ovidentia_upgrade($version_base,$version_ini) est appelée, il faut qu'elle retourne TRUE pour que la mise à jour soit acceptée.
+Lors de chaque mise à jour, la fonction ovidentia_upgrade($version_base,$version_ini) est appelée, il faut qu'elle renvoie TRUE pour que la mise à jour soit acceptée.
-La fonction se trouve dans le fichier upgrade.php
+La fonction se trouve dans le fichier upgrade.php.
 == Programme de mise à jour d'un module ==
-le principe est identique pour les module, la fonction doit être dans le fichier init.php et s'appelle addon_upgrade($version_base,$version_ini) ou addon est le nom du module
+le principe est identique pour les module, la fonction doit être dans le fichier init.php et s'appelle addon_upgrade($version_base,$version_ini) où addon est le nom du module.
@@ Ligne 15 : / Ligne 15 : @@
 === Paramètres ===
-* $version_base : le numéro de version stoqué dans la base de donnés
+* $version_base : le numéro de version stockée dans la base de données
-* $version_ini : le numéro de version stoqué dans les fichiers (fichier ini)
+* $version_ini : le numéro de version stockée dans les fichiers (fichier ini)
 lors de la mise à jour, le numéro de version $version_ini est généralement supérieur à $version_base
@@ Ligne 22 : / Ligne 22 : @@
 ===  $babBody->addError($message) ===
-Les messages d'erreur doivent être enregistrés avec la fonction $babBody->addError, il faut ensuite retourner FALSE pour que la mise à jour ne soit pas acceptée
+Les messages d'erreur doivent être enregistrés avec la fonction $babBody->addError, il faut ensuite renvoyer FALSE pour que la mise à jour ne soit pas acceptée.
 === bab_isTable($table) ===
-test l'existence d'une table
+Teste l'existence d'une table.
 === bab_isTableField($table, $field) ===
-test l'existence d'un champ de table
+Teste l'existence d'un champ de table.
 === <nowiki>bab_setUpgradeLogMsg($addon_name, $message, $uid = '')</nowiki> ===
-Permet d'enregistrer un message personalisé dans le log de mise à jour (table bab_upgrade_messages)
+Permet d'enregistrer un message personnalisé dans le log de mise à jour (table bab_upgrade_messages)
 dans le cas du noyau $addon_name doit être renseigné avec la constante BAB_ADDON_CORE_NAME.

← Version précédente		Version du 15 janvier 2008 à 09:27
Ligne 35 :		Ligne 35 :

	Permet d'enregistrer un message personalisé dans le log de mise à jour (table bab_upgrade_messages)		Permet d'enregistrer un message personalisé dans le log de mise à jour (table bab_upgrade_messages)
		+
		+	dans le cas du noyau $addon_name doit être renseigné avec la constante BAB_ADDON_CORE_NAME.

	$uid est un identifiant unique optionnel en chaîne de caractère qui peut être renseigné pour identifier un message.		$uid est un identifiant unique optionnel en chaîne de caractère qui peut être renseigné pour identifier un message.