Certains fichiers ne sont désormais plus compilés à la volée, mais uniquement pendant l’installation. Cela évite de lancer des compilateurs pendant une requête HTTP, afin d’améliorer les performances.

Fichiers compilés pendant l’installation :

• configuration
• fichiers de propriétés pour les locales
• liste des écouteurs d’événements
• correspondance des URL
• formulaires
• fichiers de templates ayant l’extension ctpl (syntaxe v2 de Castor)
• Daos

Pendant le développement, vous pouvez configurer un "watcher" de fichiers (dans votre IDE par exemple) qui appellera php dev.php compile $FULLPATH_OF_FILE, afin de compiler un seul fichier sans appeler l’installeur avant chaque test dans votre navigateur.

Autoload dans module.xml : autorise les répertoires de fallback PSR comme dans composer.json. Vous pouvez définir un répertoire sans espace de noms. Ce répertoire sera une racine pour les espaces de noms qui ne correspondent pas aux autres règles.

La syntaxe Castor v2 est désormais prise en charge dans les fichiers de templates ayant l’extension ctpl. Ces templates sont compilés pendant l’installation.

Comme, par défaut, ils sont considérés comme fiables et comme des templates HTML, la compilation d’un template peut échouer si le format n’est pas du HTML.

Aussi il est fortement recommandé d’utiliser les instructions pragma {! output-type = ... !} pour spécifier un type de contenu autre que HTML, et d’utiliser {! trusted = false!}, s’il ne s’agit pas d’un template fiable. Ainsi, la compilation pendant l’installation sera effectuée correctement.

• Les classes jLocale et jBundle sont obsolètes et remplacées par Jelix\Locale\Locale et Jelix\Locale\Bundle.
• Ces nouvelles classes ne prennent en charge que les jeux de caractères UTF-8. Jelix\Locale\Locale appelle jLocale si le jeu de caractères par défaut n’est pas UTF-8.
• Les fichiers de propriétés sont désormais compilés pendant l’installation afin d’améliorer les performances à l’exécution, et sont utilisés par les nouvelles classes. Les classes obsolètes continuent à compiler les fichiers à l’exécution.
• Nouvelles méthodes Locale::getBundle() et Bundle::getAllKeys().
• Les locales peuvent se trouver dans un répertoire extérieur à une application, par exemple dans un paquet Composer. Le répertoire doit être déclaré avec la nouvelle API jApp::declareLocalesDir().

Les classes jEvent et jEventListener sont obsolètes et remplacées par \Jelix\Event\Event et \Jelix\Event\EventListener.

La déclaration d’un écouteur d’événements peut désormais être faite dans la classe de l’écouteur avec des attributs PHP. Dans ce cas, la classe de l’écouteur peut être n’importe quelle classe, et pas seulement une classe héritant de \Jelix\Event\EventListener. Cependant, la classe de l’écouteur doit toujours être déclarée dans les fichiers event.xml.

<events xmlns="http://jelix.org/ns/events/1.0">
   <listener name="\JelixTests\Tests\Listener\TestAttrEventsListener"/>
</events>

use Jelix\Event\Attribute\ListenEvent;
use Jelix\Event\Attribute\ListenEventClass;
class TestAttrEventsListener
{
    #[ListenEvent('TestEvent')]
    function onTestEvent ($event) { }
    #[ListenEventClass]
    function testEventObject(EventForTest $event) { }
}

• Prise en charge de <placeholder> dans <input>, <textarea>, <htmleditor>, <wikieditor>.
• Les formulaires sont compilés pendant l’installation de l’application afin d’améliorer les performances à l’exécution.

jDb repose désormais sur JelixDatabase.

La classe jDb existe toujours, mais la plupart des classes internes de jDb ont disparu et sont remplacées par des classes de JelixDatabase, même si de nombreuses anciennes classes existent encore (mais peuvent être vides) afin de ne pas casser les paramètres typés dans vos classes.

Cela apporte de nouvelles fonctionnalités :

• Prise en charge des noms de schémas dans les noms de tables, pour certaines API.
• Prise en charge des colonnes générées de PostgreSQL (contributeur : Riccardo Beltrami).
• Prise en charge des colonnes Identity pour PostgreSQL.
• Correction de lastInsertId pour SQLServer.
• Prise en charge de l’API mssql supprimée. Seul le connecteur utilisant l’API sqlsrv est disponible.
• Version minimale des bases de données prises en charge :
  • Mysql : 8.*
  • PostgreSQL : 13

Les plugins pour jDb (alias « drivers ») implémentant des connecteurs, etc., ne sont plus pris en charge. Ils ont été remplacés par des classes fournies directement par le paquet JelixDatabase.

jDao repose désormais sur JelixDao.

La classe jDao reste la classe principale à utiliser pour charger et utiliser Dao. La plupart des classes internes de jDao ont disparu et sont remplacées par des classes de JelixDao, même si de nombreuses anciennes classes existent encore (mais peuvent être vides) afin de ne pas casser les paramètres typés dans vos classes.

Cela apporte de nouvelles fonctionnalités :

• prise en charge native des champs JSON : les propriétés dao ayant le datatype json sont automatiquement encodées lors d’un insert/update, ou décodées lors d’un select.
• Possibilité d’indiquer une classe dont la classe factory générée héritera. Le nom de classe doit être indiqué dans l’attribut extends de <factory>. La classe peut se trouver n’importe où et doit pouvoir être chargée automatiquement. La classe doit hériter de jDaoFactoryBase et elle doit être abstraite.

Autres changements :

• Les plugins pour le compilateur jDao (type « daobuilder ») ne sont plus pris en charge.
• Les fichiers Daos sont compilés pendant l’installation de l’application afin d’améliorer les performances à l’exécution.
• Les classes générées à partir des fichiers daos ont de nouveaux noms et sont chargées automatiquement.
• jSelectorDao, jSelectorDaoDb et jSelectorDaoRecord sont obsolètes et existent sous de nouveaux noms.

• Nouvelles méthodes jFile::mergeIniFile() et jFile::mergeIniContent().