Documentation du framework Adventy

Introduction

Cette documentation a pour objectif de présenter le framework PHP Adventy avec des exemples d'utilisation pour vous permettre de développer rapidement une application web optimisée.

Le framework Adventy facilite la conception d'applications web en PHP. Il s'inspire du MVC (Model-View-Controller) et intègre l'AOP (Aspect-Oriented Programming). La couche Controller étant automatisée et donc transparente pour le développeur, le framework Adventy repose finalement, non plus sur l'architecture MVC, mais sur l'architecture MVA, pour Model-View-Aspect.

Adventy est un framework PHP de nouvelle génération grâce à son architecture MVA. Cette innovation va aider le développeur à :

  1. s'affranchir des aspects techniques récurrents : configuration du router, contrôle de données, accès aux données, transaction, internationalisation (I18N), génération de la réponse d'un web service, compression de la réponse du côté serveur ;
  2. favoriser la conception de modules à destination de l'automatisation des tests unitaires et fonctionnels ;
  3. développer plus vite et produire plus, tout en améliorant la qualité de code et la performance.

Les pré-requis

La connaissance d'un framework PHP ou du MVC n'est absolument pas obligatoire. Le framework Adventy est accessible aux développeurs web de tout niveau, du débutant au plus expérimenté. Il suffit seulement d'avoir des notions en HTML, CSS, Javascript, PHP et SQL.

Pour utiliser le framework Adventy, nous supposerons que votre environnement de développement est déjà opérationnel (par exemple en local) :

  1. Editeur de texte ou IDE avec encodage UTF-8 sans BOM ;
  2. Environnement LAMP, WAMP, MAMP ou équivalent ;
  3. Version PHP 5.6 minimum ;
  4. Base de données MySQL ou MariaDB (si vous souhaitez en utiliser une) ;
  5. phpmyadmin ou équivalent pour gérer la base de données MySQL/MariaDB.

La version expérimentale du framework Adventy n'utilise que la base de données MySQL/MariaDB pour le moment. D'autres bases de données suivront : PostgreSQL, Oracle.

Débuter avec le framework Adventy (AF)

La documentation est divisée en plusieurs parties. Bien que chaque partie soit indépendante, il est recommandé de suivre l'ordre proposé ci-dessous afin de bien comprendre la logique du framework :

  1. Le framework Adventy : installation et configuration du framework ;
  2. Les dossiers et fichiers : organisation des dossiers et des fichiers d'un projet Adventy ;
  3. La template de page : personnalisation du modèle de page ;
  4. Les pages statiques : création d'une page statique et de la mise en cache ;
  5. Les pages dynamiques : création d'une page dynamique ;
  6. Les pages index : gestion des pages index (pages d'accueil des dossiers) ;
  7. Les CSS d'application et de page : application des feuilles de styles ;
  8. Les scripts d'application et de page : intégration du Javascript ;
  9. Le BO : développement des modèles métiers (Business Object) ;
  10. Le DAO : accès à la base de données (Data Access Object) MySQL et transaction ;
  11. L'AOP : programmation orientée aspect ;
  12. Les formulaires : génération des champs et contrôle des données ;
  13. Les évènements : appel AJAX ;
  14. Les web services : création de web services ;
  15. L'internationalisation : création d'un site multilingue (I18N) ;
  16. Les test unitaires : tests unitaires et fonctionnels automatisés.