Список устаревших классов ядра Joomla 1.6-3.10 и их современные аналоги в ядре Joomla 5.x

Разработчикам при обновлении расширений на архитектуру Joomla 4 / Joomla 5 нередко не сразу удаётся найти аналоги устаревших методов ядра. Особенно, если под  рукой нет современной среды разработки (IDE), например PHP Storm, который подсказывает нужные методы ядра Joomla. Без него, конечно, разработка для Joomla становится непростым делом. В этой статье вы найдете табличку соответствия старых и новых названий PHP классов ядра Joomla и её расширений для того, чтобы быстрее и легче было обновить свои расширения. Эти классы пока что можно использовать в случае, если включён плагин обратной совместимости Joomla 4 / Joomla 5. Но в Joomla 6 или последующих версиях он может быть удалён.

Таблица соответствия старых классов ядра Joomla и новых namespaces

Список строился на основе Joomla 5.1.2. Цветом помечены классы, помеченные как устаревшие. Это означает, что в следующих версиях Joomla их будут удалять и использовать их в своих расширениях уже небезопасно. Согласно скорректированному плану развития Joomla удаление устаревшего класса может произойти в мажорной версии, следующей за той, где была установлена пометка deprecated (но не обязательно). Тем не менее, использование устаревших классов в своём коде - это всегда риск, которого лучше избегать.

Также вы самостоятельно можете увидеть актуальный список классов в файлах plugins/behaviour/compat/src/classmap/classmap.php и plugins/behaviour/compat/src/classmap/extensions.classmap.php.

Пример кода: вместо

<?php
$params = new JRegistry();
// ИЛИ
$params = new JRegistry($item->params);

теперь нужно писать с использованием namespaces. В начале файла в секции use... пишем 

<?php
use \Joomla\Registry\Registry;

// и далее ниже по коду, где необходимо
$params = new Registry($item->params);

Таблица соответствия старых классов РАСШИРЕНИЙ ядра Joomla и новых namespaces