Différences

Ci-dessous, les différences entre deux révisions de la page.

--- developpement_de_phpcompta [2013/03/23 15:52] – [Nouvelle méthode] dany
+++ developpement_de_phpcompta [2025/06/15 17:14] (Version actuelle) – [La documentation] dany
@@ Ligne 1: / Ligne 1: @@
-======Développement de PhpCompta======
+======Développement de NOALYSS ======
 =====Intro=====
@@ Ligne 21: / Ligne 21: @@
 Un contrôle est une page php, qui en fonction de l'action demandé va inclure la page «modèle» qu'il faut.
-Dans phpcompta, cette page est :
+Dans NOALYSS, cette page est :
 do.php 	pour toutes les demandes de pages
@@ Ligne 128: / Ligne 128: @@
 J'utilise Doxygen afin de générer le code ce sont les TAGS brief, param... Cela me permet de générer une documentation; cette documentation me permet de développer plus vite et de mieux vérifier la qualité du code.
+Voir le résultat ici [[https://wiki.noalyss.eu/doc/]]
+==== NOALYSS ====
-====PhpCompta====
+NOALYSS utilise le MVC, toutes les actions sont controlées par do.php pour les pages web, export.php pour tous les exports (PDF, ODT ou CSV). Ce sont les contrôleurs.
-PhpCompta utilise le MVC, toutes les actions sont controlées par do.php pour les pages web, export.php pour tous les exports (PDF, ODT ou CSV). Ce sont les contrôleurs.
@@ Ligne 158: / Ligne 158: @@
 =====La partie base de données=====
-====Ancienne méthode (non recommandée)====
+[[developpement:base_de_donnée_ancienne_méthode]]
-On avait commencé ainsi, on générait le fichier php à une table grâce à un script (dans phpcompta/dev/manage-code/create-file/create-phpclass.py)
+==== Les mises à jour ====
+Depuis 2005, dans phpcompta, il y a une table VERSION qui contient le numéro du dernier patch appliqué. Quand le fichier do.php est exécuté, il vérifie si le nombre DBVERSION contenu dans constant.php correspond à la version actuelle
-Les colonnes de la table sont dans un tableau et déclaré comme variable privée. Ce point est important. Cela oblige à utiliser les setters/getters. Cela vous permet aussi de faire correspondre des noms parlants à des noms de colonnes parfois hmm... moins parlants.
-Cependant, je préfère souvent utiliser les commandes SQL plutôt que de passer par les objets. D'abord pour des raisons de performance, d'utilisation de la mémoire... La théorie qui veut que l'application doit être indépendante de la base de données n'est pas un mauvais principe mais dans la vie réelle, il est rare que l 'on change le programme de base de données pour un autre.
 <code php>
-class Todo_List
+/* Ficher do.php */
+if (DBVERSION < dossier::get_version($cn))
 {
+    echo '<h2 class="error" style="font-size:12px">' .
+     _("Attention: la version de base de donnée est supérieure à la version du programme, vous devriez
+ mettre à jour") . '</h2>';
+}
+if (DBVERSION > dossier::get_version($cn))
+{
+    echo '<h2 class="error" style="font-size:12px">' . _("Votre base de données n'est pas à jour") . '   ';
+    $a = _("cliquez ici pour appliquer le patch");
+    $base = dirname($_SERVER['REQUEST_URI']) . '/admin/setup.php';
+    echo '<a hreF="' . $base . '">' . $a . '</a></h2>';
+}
-  private static $variable=array(
-				 "id"=>"tl_id",
-				 "date"=>"tl_date",
-				 "title"=>"tl_title",
-				 "desc"=>"tl_desc",
-				 "owner"=>"use_login");
-  private $cn;
-  private  $tl_id,$tl_date,$tl_title,$use_login;
-  function __construct ($p_init) {
-    $this->cn=$p_init;
-    $this->tl_id=0;
-    $this->tl_desc="";
-    $this->use_login=$_SESSION['g_user'];
-  }
 </code>
+Dans le cas où DBVERSION n'est pas la valeur contenue dans la base de donnée, do.php vous propose d'appliquer le patch sur vos bases de données. Voici la fonction qui applique les patch SQL pour la base de données
+<code php>
+/* fichier setup.php */
+//----------------------------------------------------------------------
+// Upgrade the folders
+//----------------------------------------------------------------------
+for ($e=0;$e < $MaxDossier;$e++) {
+   $db_row=Database::fetch_array($Resdossier,$e);
+  echo "<h3>Patching ".$db_row['dos_name'].'</h3>';
+  $name=$cn->format_name($db_row['dos_id'],'dos');
-Ici voici, des setters / getters génériques, ce qui permet de ne pas en avoir un par variable. Ce qui est bien pratique. On accède aux données avec set_parameter ('date','01.01.2009') ou avec get_parameter ('date');
+  if ( $cn->exist_database($name)> 0 )
+  {
+    $db=new Database($db_row['dos_id'],'dos');
+    $db->apply_patch($db_row['dos_name']);
+    Dossier::synchro_admin($db_row['dos_id']);
+  } else
-<code php>
+  {
+      echo_warning(_("Dossier inexistant")." $name");
-public function get_parameter($p_string) {
-    if ( array_key_exists($p_string,self::$variable) ) {
-      $idx=self::$variable[$p_string];
-      return $this->$idx;
-    }
-    else
-      exit (__FILE__.":".__LINE__.'Erreur attribut inexistant');
   }
-  public function set_parameter($p_string,$p_value) {
+ }
-    if ( array_key_exists($p_string,self::$variable) ) {
-      $idx=self::$variable[$p_string];
-      if ($this->check($idx,$p_value) == true )      $this->$idx=$p_value;
-    }
-    else
-      exit (__FILE__.":".__LINE__.'Erreur attribut inexistant');
-  }
-</code>
-Ceci est la fonction qui contrôle que les données sont valides. Cela pourrait aussi être fait dans la base de données, soit avec des contrôles d'intégrités (foreign key, primary key) soit avec des procédures SQL embarquées de contrôle.
-<code php>
-public function check($p_idx,&$p_value) {
-	if ( strcmp ($p_idx, 'tl_id') == 0 ) { if ( strlen($p_value) > 6 || isNumber ($p_value) == false) return false;}
-	if ( strcmp ($p_idx, 'tl_date') == 0 ) { if ( strlen(trim($p_value)) ==0 ||strlen($p_value) > 12 || isDate ($p_value) == false) return false;}
-	if ( strcmp ($p_idx, 'tl_title') == 0 ) {
-	  $p_value=substr($p_value,0,120) ;
-	  return true;
-	}
-	if ( strcmp ($p_idx, 'tl_desc') == 0 ) { $p_value=substr($p_value,0,400) ; return true;}
-	return true;
-  }
 </code>
-Enfin la fonction save, qui permet soit d'ajouter soit de même à jour. Évidemment on utilisera des requêtes SQL Prepare, afin d'éviter les problèmes de guillemets et donc d'injection SQL.
+La fonction qui applique le patch est Database::apply_patch  voir [[https://wiki.noalyss.eu/doc/class_database.html|la documentation en ligne]]
-<code php>
-public function save() {
-    if (  $this->get_parameter("id") == 0 )
-      $this->insert();
-    else
-      $this->update();
-  }
-  public function insert() {
+Tous les patchs pour la base de données se trouve dans noalyss/html/admin/sql/patch et sont numérotés dans l'ordre d’exécution.
-    if ( $this->verify() != 0 ) return;
+Chaque patch commence par
+<code sql>
-    $sql="insert into todo_list (tl_date,tl_title,tl_desc,use_login) ".
+begin;
-      " values (to_date($1,'DD.MM.YYYY'),$2,$3,$4)  returning tl_id";
-    $res=ExecSqlParam($this->cn,
-		 $sql,
-		 array($this->tl_date,
-		       $this->tl_title,
-		       $this->tl_desc,
-		       $this->use_login)
-		 );
-    $this->tl_id=pg_fetch_result($res,0,0);
-  }
-  public function update() {
-    if ( $this->verify() != 0 ) return;
-    $sql="update todo_list set tl_title=$1,tl_date=to_date($2,'DD.MM.YYYY'),tl_desc=$3 ".
-      " where tl_id = $4";
-    $res=ExecSqlParam($this->cn,
-		 $sql,
-		 array($this->tl_title,
-		       $this->tl_date,
-		       $this->tl_desc,
-		       $this->tl_id)
-		 );
-  }
 </code>
-Comme cette partie est vraiment répétitive et change peu, j'ai mis au point un script (dev/manage-code/create-file/create_phpclass.py) pour directement générer le code sur base de la définition d'une table. Cela réduit vraiment le temps de travail.
+et termine par
+<code sql>
+update version set val=13;
-<code php>
-static function test_me() {
-    $cn=DbConnect(dossier::id());
-    $r=new Todo_List($cn);
-    $r->set_parameter('title','test');
-    $r->use_login='phpcompta';
-    $r->set_parameter('date','02.03.2008');
-    $r->save();
-    $r->set_parameter('id',3);
-    $r->load();
-    print_r($r);
-    $r->set_parameter('title','Test UPDATE');
-    $r->save();
-    print_r($r);
-    $r->set_parameter('id',1);
-    $r->delete();
-  }
-    public function get_info() {
-    return var_export(self::$variable,true);
-}
+commit;
 </code>
+Ainsi, si le script échoue, la mise à jour s'arrête et annule toute ce qui a été fait dans le script contenant l'erreur, la base de données reste ainsi dans un état cohérent. Une fois l'erreur corrigée dans votre base de données, ce script ainsi que ceux qui suivent seront appliqués quand vous appelerez à nouveau phpcompta/admin/setup.php
+====Accèder aux données : DAO ====
-Et finalement, les fonctions info et test_me qui sont très utiles lors des phases de déboggages. Je crée une simple page html/test.php et j'appelle la classe; dans la fonction test_me je mets tout ce que je souhaite tester.
-====Nouvelle méthode====
-Nous avons créér une classe Phpcompta_Sql qui va nous permettre de faire la même chose en très peu de ligne de code.
+Nous avons créér une classe qui va hériter de [[http://www.phpcompta.eu/doc/classPhpcompta__SQL.html|Phpcompta_Sql]] et qui va nous permettre de faire la même chose en très peu de ligne de code.
@@ Ligne 379: / Ligne 299: @@
 </code>
 Si on change la structure d'une table, il ne faut presque rien changer : seulement quelques lignes.
+===== Les tests unitaires =====
+On utilise dans chaque class , une fonction nommée [[developpemement::test_me]] qui pouvait être appelée depuis le fichier test.php.
+A partir de NOALYSS (version 6.7.2.0), et pour les plugins nous utiliserons PHPUnit.Ces tests sont heureusement appelables directement depuis NetBeans (version 7.4 et supérieure).
+Il faut tout d'abord un fichier bootstrap qui contient le path correct pour php ainsi que les variables comme $g_user ou $cn, l'inclusion de [[:config.inc.php]] et de constant.php
+     La documentation plus complète se trouve dans le manuel [[https://manuel-fr.noalyss.eu/#_d%C3%A9veloppement_noalyss|Chapitre Développement de Noalyss]]