Warning: the documentation is not updated yet with all these changes.

Jelix 1.9 is now compatible from PHP 8.2 to PHP 8.5.

Main new features ¶

New features ¶

<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) { }
}

• Remove support of bytecode cache other than opcache.
• Remove jacl and jacldb modules. There are still available into the jelix/jacl-module package. But you should consider it as an archive. You should migrate to jacl2 and jacl2db.
• Remove jpref and jpref_admin modules. There are still available into the jelix/jpref-module package. But you should consider it as an archive. You should develop an alternative to these modules.
• Plugins for jDb and jDao don't exist anymore.
• All error messages are now only in english. No more jelix~db.*, jelix~daoxml.* and jelix~dao.* locales.
• No more support of phpunit tests into modules. tests/runtests.php into application does not work anymore.

• Catching an exception about invalid/unknown profil (jProfile) must be done by catching \Jelix\Profiles\Exception instead of jException from now.
• jFormsCompiler, jFormsCompiler_jf_1_0, jFormsCompiler_jf_1_1 have been renamed to Jelix\Forms\Compiler\FormCompiler, Jelix\Forms\Compiler\/XmlCompiler10, Jelix\Forms\Compiler\/XmlCompiler11, and so, are not existing anymore.

• The charset configuration property is deprecated. You should keep the default value to UTF-8. If not, convert your locales and other data to UTF-8 as the support of other charset will be gone in the next major version.
• \Jelix\Core\Profiles must be used instead of jProfiles. Same API, but it is now relying on the JelixProfiles library. jProfiles is deprecated as well as methods storeInPool, getFromPool, getOrStoreInPool. Use storeConnectorInPool, getConnectorFromPool, getConnectorFromCallback instead.
• If there are some plugins for jProfiles, they must inherit from \Jelix\Profiles\ReaderPlugin instead of jProfilesCompilerPlugin, or they must implement at least of the new interface \Jelix\Profiles\ProfilePluginInterface. jProfilesCompilerPlugin is deprecated.
• jClassBinding
• jelix_read_ini
• jDao: method type xml. A PHP class should be used instead, that is declared into the extends attribute of <factory>.
• css http request object is deprecated.
• constant JELIX_SCRIPTS_PATH is now deprecated, as it becomes useless.
• Functions declared into the namespace Jelix\Utilities are deprecated. Use them from the namespace Jelix\Core\Utilities.
• Interface \jelix\Core\ConfigCompilerPluginInterface is deprecated. use \Jelix\Core\Config\CompilerPluginInterface instead.
• selector classes: jSelectorAppCfg, jSelectorCfg, jSelectorDebugAction, jSelectorLib, jSelectorTmp, jSelectorVar
• replace jSelectorModule by Jelix\Core\Selector\ModuleSelector
• replace jISelector by Jelix\Core\Selector\SelectorInterface
• replace jExceptionSelector by Jelix\Core\Selector\Exception
• jelix_scan_module_sel
• classes jLocale and jBundle are deprecated, and replaced by Jelix\Locale\Locale and Jelix\Locale\Bundle.
• The method jConfigCompiler::findServerName() has been moved to jServer
• jSelectorForm

About jDb:

• jDbConnection and jDbPDOConnection are deprecated and replaced by objects implementing Jelix\Database\ConnectionInterface and Jelix\Database\ConnectionConstInterface
  • constants FETCH_*, ATTR_* and CURSOR_* are moved to ConnectionConstInterface
• jDbResultSet and jDbPDOResultSet are deprecated and replaced by objects implementing Jelix\Database\ResultSetInterface
• jDbParameters is deprecated and replaced by \Jelix\Database\AccessParameters
  • public methods are the same, however getParameters() is deprecated, getNormalizedParameters() should be used instead
• jDbTools is deprecated and replaced by objects implementing Jelix\Database\Schema\SqlToolsInterface
  • methods getFieldList() and getTableList() are deprecated
  • constants IBD_* are moved to SqlToolsInterface
• jDbSchema is deprecated and replaced by objects implementing Jelix\Database\Schema\SchemaInterface
• jDbIndex, jDbConstraint, jDbUniqueKey, jDbPrimaryKey, jDbReference, jDbColumn, jDbTable are replaced by some classes of the Jelix\Database\Schema\ namespace.
• jDbUtils and jDbUtils::getTools() is deprecated and is replaced by \Jelix\Database\Connection::getTools()
• jDbWidget is deprecated and replaced by Jelix\Database\Helpers
• jDaoDbMapper::createTableFromDao() returns an object \Jelix\Database\Schema\TableInterface instead of jTable

About jDao:

• jDaoFactoryBase is replaced by objects implementing Jelix\Dao\DaoFactoryInterface
• jDaoRecordBase is replaced by objects implementing Jelix\Dao\DaoRecordInterface
  • methods getDbProfile and setDbProfile don't exist on Jelix\Dao\DaoRecordInterface.
  • method getSelector() is deprecated, getDaoName() should be used instead.
• jDaoConditions and jDaoCondition are deprecated and replaced by \Jelix\Dao\DaoConditions and \Jelix\Dao\DaoCondition.
• jDaoXmlException is deprecated and not used anymore. The parser generates Jelix\Dao\Parser\ParserException instead.
• jDaoGenerator and jDaoParser are removed
• jDaoMethod is replaced by Jelix\Dao\Parser\DaoMethod
• jDaoProperty is replaced by Jelix\Dao\Parser\DaoProperty
• jDaoDbMapper is replaced by Jelix\Dao\DbMapper
• jDaoSelector* classes are replaced by Jelix\Dao\DaoSelector* classes

• constant JELIX_SCRIPTS_PATH: its value is now <vendor path>/lib/JelixFramework/DevHelper/.

• Laurent Jouanneau
• Raphael Martin
• Riccardo Beltrami