fr:presentation - Jelix.org

Piste :
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
~~LANG:EN@en:features~~

====== Présentation de Jelix ======


===== Généralités =====


Jelix est un framework pour PHP 7.4 et 8  qui aide les développeurs à la réalisation d'applications ou de sites web en tout genre.

Il propose :

  * un ensemble d'API qui prend en charge nombre d'aspects techniques : accès aux données, moteur de templates, générateurs de contenus (HTML, JSON, XML, ...), services web (SOAP, xml-rpc, json-rpc,...), générateur de formulaires, CRUD générique, authentification, gestion de droits, localisation etc..
  * une structure modulaire et une organisation des fichiers du projet, imposant donc un cadre et des normes de développement.
  * Une cinématique MVC (Model, View, Controller), permettant un découpage "en couche" du projet.

Ces caractéristiques permettent une meilleure réutilisation du code, une capitalisation du savoir-faire, une meilleure organisation dans le développement, tout ceci ayant alors pour conséquence une meilleure productivité.

Jelix utilise au maximum les spécificités de PHP 7.4, afin d'être le plus léger et le plus performant possible.

====== Philosophie ======

Nous développons Jelix en gardant ces mots en tête :

   * **Performance**: le framework doit être le plus performant possible (optimisation du code, système de caches, version optimisée pour les serveurs de production etc..)
   * **Simplicité**: fournir des API simple et puissante à la fois, fournir des scripts pour générer des modules, scripts...
   * **Flexibilité**: permettre la modularisation, l'utilisation de plugins, le découplage (avec modération)
   * **Robustesse**: les réponses aux navigateurs se font toujours dans le format attendu, même en cas d'erreur.
   * **Pragmatisme**: ne pas réinventer des API si PHP fourni nativement ce qu'il faut.


===== Fonctionnalités proposées =====

==== Fonctions et caractéristiques originales ====

   * **Architecture modulaire** : une application peut être découpée en plusieurs modules réutilisables.
   * **Garantie minimale sur l'échange des données** : Jelix contrôle la génération des formats de sortie en fonction du type de requête. Par exemple, s'il s'agit d'une requête pour un service web XML-RPC, il n'est pas possible de générer du HTML, la réponse sera obligatoirement en XML-RPC. Cela offre donc une certaine robustesse de l'application dans la communication client-serveur.
   * **Génération des erreurs techniques dans le format spécifié**. Grâce au système de Jelix décrit précédemment, toutes les erreurs techniques sont renvoyées dans le format attendu par le client. Pas d'erreur formatée en HTML alors que le client attend une réponse en XML-RPC ou JSON par exemple.
   * **jDAO, mapping objet-relationnel** reposant sur le design pattern DAO (Data Access Object), se basant sur des fichiers déclaratifs en XML et prenant en charge la génération automatique des requêtes SQL, des problématiques de sécurité (SQL injection etc...). jDao génère des classes PHP avec les requêtes SQL "en dur", permettant alors des performances accrues par rapport à d'autres ORM.
   * **jForms, générateur de formulaire** : à partir d'un simple fichier XML, jForms génère un formulaire en HTML avec la validation javascript adéquate, vérifie les données saisie coté serveur, effectue le chargement ou la sauvegarde des données etc.. Il peut gérer plusieurs instances d'un formulaire en même temps. 
   * **Moteur de template très léger, performant et évolutif** (jTpl), avec pour les templates une syntaxe à mi-chemin entre Smarty et PHP. Un système de plugin "à la Smarty" est également disponible.
   * **Système événementiel**, permettant la communication entre module.
   * **Surcharge de fichier** : il est possible de redéfinir certains fichiers d'un module sans toucher aux originaux (daos, templates, locales, formulaires). Cela permet de partager un même module par plusieurs applications, de faciliter sa mise à jour.
   * **Déclarations de zones de pages** : la construction d'une page web peut se "découper" en plusieurs zones, chaque zone étant paramétrable, ayant son propre code métier, son propre template, permettant alors de les réutiliser dans plusieurs pages. Chaque zone peut également être mise en cache indépendamment.
   * **Désignation des fichiers et ressources par des sélecteurs**, et non par des chemins physiques, apportant alors une indépendance d'un module vis à vis de l'installation.

==== Fonctions et caractéristiques classiques ====

   * **Services Web** : Jelix prend en charge l'analyse du contenu des requêtes, et la génération des réponses pour les appels de services web en SOAP, XML-RPC, JSON-RPC ou JSON. D'autres types de services web sont tout à fait envisageables. 
   * **Prise en charge de RESTfull** : par simple implémentation d'une interface, on peut définir facilement les traitements suites aux requetes HTTP GET/POST/PUT/DELETE.
   * **Système de thèmes** : il est possible de définir plusieurs thèmes, chacun redéfinissant les templates des modules.
   * **Système de génération automatique et de mapping d'url** : pas d'url en dur dans Jelix. C'est le framework qui se charge de générer les urls dans les templates ou ailleurs, en fonction de la configuration du mapping url définit sur les actions.
   * **CRUD générique** : Jelix propose un contrôleur générique permettant de faire une interface d'administration d'une table SQL en quelques lignes de code, avec l'aide de jDao et jForms
   * **Des scripts PHP de génération de code** à exécuter en ligne de commande, permettant la création rapide des divers fichiers d'un projet (module, dao, template, controlleur etc)
   * **Système de cache technique** : quasiment tous les fichiers non PHP d'un projet Jelix sont "compilés" en PHP afin d'améliorer les performances (templates, dao, évènements etc..).
   * **Compatible UTF-8**. C'est d'ailleurs l'encodage par défaut du framework.
   * **Module dédié aux tests unitaires** : les tests unitaires sont essentiels pour créer une application qui soit fiable. Jelix propose donc un module qui fourni une interface pour lancer les tests unitaires et un moyen simple de créer des tests unitaires (reposant sur SimpleTest)
   * **L'architecture du coeur est du type MVC** (Model-View-Controller). Un coordinateur se charge de lancer l'exécution d'une action précise en fonction des paramètres dans l'url. Les actions possibles sont implémentées dans des classes de type jController (contrôleurs).
   * Jelix propose **différents générateurs de format** (les objets jResponse) : XHTML, CSS, ATOM, RSS, XML, RDF, ZIP, PDF (via TCPDF). D'autres formats sont bien sûr possible.
   * **Couche d'abstraction d'accès aux bases de données** : jDb repose sur PDO ou sur ses propres classes (quand PDO n'est pas disponible) pour accéder aux bases de données.
   * **Localisation** : il est possible d'avoir son application en plusieurs langues. Le stockage des chaînes localisées se fait dans des fichiers properties.
   * **Système d'authentification et de gestion de droits**.
   * Utilisation du XML : déclaration des évènements, des DAOs etc... Cela permet de faciliter l'écriture, de générer et modifier facilement ces parties d'un projet par des outils tiers, et donc d’accroître la productivité.

===== Principe de fonctionnement =====

{{http://jelix.org/images/schema_logic.png}}

  - Jelix reçoit une requête HTTP. Il instancie un objet jRequest qui contient les données de la requête, et instancie le contrôleur qui correspond à l'action.
  - La méthode du contrôleur correspondante à l'action est exécutée. La méthode  récupère les paramètres de requête pour déterminer les traitements à suivre.
  - Le contrôleur exécute les traitements métiers et récupère éventuellement des résultats qui seront utilisés pour l'affichage
  - Le contrôleur instancie un objet de type jResponse auquel il assignera les données à afficher, initialisera les templates etc.
  - Jelix récupère cet objet jResponse, invoque la génération du document en sortie et envoi ce dernier au navigateur.

===== Une première application =====

Lire [[fr:tutoriels:minitutoriel|le mini tutoriel]].
fr/presentation.txt · Dernière modification : 2024/04/24 14:21 de laurent