• configuration qui gère les objets du même nom ; elle sert à lire et écrire à la volée des configurations. J'y reviendrais un peu plus tard.
  
• database est la classe d'accès à la base de données. Elle gère uniquement mysql, et utilise une syntaxe singleton. J'y reviendrais aussi en détails.
  
• erreur est une classe statique qui sert à générer des erreurs et à les écrire dans un fichier de logs. Elle est principalement utilisée par database, mais vous pouvez bien sûr l'utiliser aussi dans votre application.
  
• filtrage est une classe statique qui contient des méthodes de filtrage de formulaire spéciales et que vous souhaitez appliquer à vos champs. J'y reviendrais en parlant des formulaires.
  
• formulaire est une classe de traitement des formulaires. Elle permet, via un fichier de configuration en php, de générer des formulaires, et de les traiter directement.
  
• langue permet de gérer l'interface multi-langue. J'y reviendrais (encore).
  
• module est une classe abstraite qui sert de base à (presque) toutes les classes que vous développez pour le framework. C'est l'une des classes les plus importante (formulaire en hérite, entre autres).
  
• utilisateur est une classe qui sert à gérer les actions de base de l'utilisateur. Elle est prévue pour être héritée.
  

<?php 

$configuration = new configuration('monfichier'); 

<?php 

$maValeur = $configuration->maValeur;

$configuration->maValeur = 3 

<?php 

foreach($langue as $clef => $valeur)

{

} 

<?php 

$db = new database(); 

<?php 

$db = database::create(); 

<?php 

if($_SESSION['utilisateur']->administrateur())

{

echo 'Bonjour grand chef';

} 

<?php 

echo $_SESSION['utilisateur']->login; 

<?php 

protected $nomModule = 'monModule'; 

<?php 

$this->parserArray['clef'] = 'Bonjour'; 

<?php 

Bonjour <!-- TEST ESTADMINISTRATEUR -->monsieur l'administrateur<!-- FINTEST ESTADMINISTRATEUR --> 

<?php 

$this->masquesArray[] = 'estAdministrateur'; 

Citation :Bonjour

<?php

    

    class defautIndex extends module

    {

        protected $nomModule = 'defautIndex';

        

        public function index()

        {

            $this->nomVue = 'index';

        }

    }

?>

<?php 

public function monAction()

{

$this->nomVue = 'maVueAvecUnFormulaire';

$formulaire = new formulaire('monFormulaire');

$this->parserArray['formulaire'] = $formulaire->voirFormulaire();

} 

• origine sert à spécifier l'origine du formulaire. Le principe est que la classe peut charger un formulaire directement de la base de données (origine DB) ou depuis le tableau (origine Array). Lorsque le formulaire est chargé depuis la base de données, il n'est pas nécessaire de détailler tous les champs, les champs que vous n'indiquerez pas seront simplement ajoutés par le système.
  
• titre sert à donner un titre à votre formulaire. Ce titre sera utilisé comme légende du fieldset correspondant.
  
• valider est le texte du bouton valider. Dans les fait, c'est facultatif, mais bon...
  
• raz sert à remettre à zéro le formulaire (bouton de type reset). Si vous n'indiquez pas ce champs, il n'y aura pas de bouton.
  
• action sert à préciser l'action du formulaire et ce qui se passera ensuite. C'est un tableau associatif qui attends les clefs suivantes :
  • type doit indiquer quoi faire avec les données. Les valeurs possibles sont no pour ne pas traiter les données (par exemple pour passer directement à un autre formulaire, si vous sélectionnez un utilisateur à modifier puis que vous affichez le formulaire de modification), fonction pour indiquer une fonction à executer dans un module précis, insert pour insérer les données dans une table, update pour mettre à jour les données d'une table, delete pour supprimer les données d'une table. Notez que les formulaires d'origine DB doivent avoir comme type d'action insert, update ou delete.
    
  • cible doit indiquer la cible de l'action. Ceci est inutile si le type est no. Si le type est à fonction, ce champs doit indiquer le module et le nom de l'action de se module, sous la forme module.action. Par exemple, pour connecter un utilisateur (module utilisateur, fonction connect_user), on doit mettre utilisateur.connect_user. A noter qu'aucune valeur n'est passée en paramètre à cette fonction, c'est à elle de récupérer les valeures du tableau $_POST (qui auront au préalable été protégées par la classe). Enfin, si le formulaire a pour action une table d'une base, la cible doit être le nom de cette table.
    
  • where indique une clause à utiliser dans le cadre des formulaires dont l'action est update ou delete. Deux possibilités ici : si vous indiquez simplement un champ présent dans le formulaire (par exemple, id), alors ce sera la valeur de ce champs qui sera utilisé au traitement. Mais ceci n'est pas valable dans le cas de formulaire chargés de la base (origine DB) : il faut alors spécifier une clause WHERE complète ('id = ' . intval($_POST['id'])). Pour des raisons de sécurité, il est vivement recommandé de protéger cette clause, comme dans mon exemple, car la protection liée au système interviendra après le chargement et le traitement de cette clause.
    
  • vue doit indiquer le nom de la vue à afficher ensuite. A noter que les noms de vue de formulaire doivent être précédés d'un _ : par exemple, si vous indiquez "commun_connexion" comme nom de vue, alors le fichier sera _commun_connexion.html. Ce paramètre est facultatif, mais si il n'est pas renseigné, le paramètre fvue doit l'être.
    
  • fvue indique une fonction a executer. Si ce paramètre est rempli, lorsque le formulaire aura été traité, le système appellera la fonction comme si il s'agissait d'un affichage, et l'affichera directement. La fonction doit être indiquée de la même manière que pour la cible des formulaires dont l'action est de type fonction.
    
  
  
  Pour des raisons de commodité (pour moi), le framework, sa documentation et son téléchargement sont en cours de déplacement vers mon nouveau blog.
  
  Le lien pour télécharger le framework est donc devenu celui-ci :
  
  http://www.ames-troubles.com/post/Mon-propre-framework

• Tous les commentaires en anglais ( peut être les laisser en français à côté )
  
• Mettre des commentaires quand ils sont absents
  
• Adoption de la syntaxe PHPDoc
  
• Nom de variables, constantes, fonctions en anglais. No need mélanger de manière étrange l'anglais et le français
  
• Renommer les classes, j'suis un peu maniaque et j'aime bien voir les classes avec une majuscule
  
• Tenir à jour la documentation
  
• La compléter