跳至主要内容

新弃用

所有应该知道的弃用内容，以及你现在应该使用什么代替。

待办事项

此页面尚未完成，请使用此页面底部的编辑此页面链接，帮助使其更实用。

文件弃用

作为重组的一部分，有可能移动文件或类获得一个命名空间。通常，当类获得一个命名空间或被移动到新目录时，我们也会从旧位置中移除文件。作为向后兼容性的增强，Joomla! 会保留已知直接包含/所需的文件。例如，在 Joomla 4 中，组件助手从 components/helpers/banners.php 移动到 components/src/Helper/bannersHelper.php，类获得命名空间 \Joomla\Component\Banners\Administrator\Helper\BannersHelper。

类将别名为 libraries/classmap.php 或 libraries/extensions.classmap.php。在下一个主要版本中，所有别名将迁移到战斗插件。文件将保留到下一个主要版本，在此版本中，文件和别名将被移除.

待办事项

上面的部分应移至弃用策略.

计划在 Joomla 中移除！6.0 别名已在 5.0 中添加到战斗插件.

  • administrator/components/com_banners/helpers/banners.php

  • administrator/components/com_categories/helpers/categories.php

  • administrator/components/com_contact/helpers/contact.php

  • administrator/components/com_content/helpers/content.php

  • administrator/components/com_contenthistory/helpers/contenthistory.php

  • administrator/components/com_fields/helpers/fields.php

  • administrator/components/com_installer/helpers/installer.php

  • administrator/components/com_menus/helpers/menus.php

  • administrator/components/com_modules/helpers/modules.php

  • administrator/components/com_newsfeeds/helpers/newsfeeds.php

  • administrator/components/com_plugins/helpers/plugins.php

  • administrator/components/com_redirect/helpers/redirect.php

  • administrator/components/com_templates/helpers/template.php

  • administrator/components/com_templates/helpers/templates.php

  • administrator/components/com_users/helpers/users.php

  • components/com_contact/helpers/route.php

  • components/com_finder/helpers/route.php

  • components/com_newsfeeds/helpers/route.php

  • components/com_tags/helpers/route.php

已完成的类

\Joomla\CMS\Log\DelegatingPsrLogger​

文件：libraries/src/Log/DelegatingPsrLogger.php

类变为最终并标记为内部，因此它不能被覆盖 (原因).

  • libraries/src/Image/Image.php

类弃用

计划在 Joomla 中移除！6.0

BannersHelper​

文件：administrator/components/com_banners/helpers/banners.php
替换：\Joomla\Component\Banners\Administrator\Helper\BannersHelper

CategoriesHelper​

文件：administrator/components/com_categories/helpers/categories.php
替换：\Joomla\Component\Categories\Administrator\Helper\CategoriesHelper

ContactHelper​

文件：administrator/components/com_contact/helpers/contact.php
替换：\Joomla\Component\Contact\Administrator\Helper\ContactHelper

ContentHelper​

文件：administrator/components/com_content/helpers/content.php
替换：\Joomla\Component\Content\Administrator\Helper\ContentHelper

ContenthistoryHelper​

文件：administrator/components/com_contenthistory/helpers/contenthistory.php
替换：\Joomla\Component\Contenthistory\Administrator\Helper\ContenthistoryHelper

FieldsHelper​

文件：administrator/components/com_fields/helpers/fields.php
替换：\Joomla\Component\Fields\Administrator\Helper\FieldsHelper

InstallerHelper​

文件：administrator/components/com_installer/helpers/installer.php
替换：\Joomla\Component\Installer\Administrator\Helper\InstallerHelper

文件：administrator/components/com_menus/helpers/menus.php
替换：\Joomla\Component\Menus\Administrator\Helper\MenusHelper

ModulesHelper​

文件：administrator/components/com_modules/helpers/modules.php
替换：\Joomla\Component\Modules\Administrator\Helper\ModulesHelper

NewsfeedsHelper​

文件：administrator/components/com_newsfeeds/helpers/newsfeeds.php
替换：\Joomla\Component\Newsfeeds\Administrator\Helper\NewsfeedsHelper

PluginsHelper​

文件：administrator/components/com_plugins/helpers/plugins.php
替换：\Joomla\Component\Plugins\Administrator\Helper\PluginsHelper

RedirectHelper​

文件：administrator/components/com_redirect/helpers/redirect.php
替换：\Joomla\Component\Redirect\Administrator\Helper\RedirectHelper

TemplateHelper​

文件：administrator/components/com_templates/helpers/template.php
替换：\Joomla\Component\Templates\Administrator\Helper\TemplateHelper

TemplatesHelper​

文件：administrator/components/com_templates/helpers/templates.php
替换：\Joomla\Component\Templates\Administrator\Helper\TemplatesHelper

UsersHelperDebug​

文件：administrator/components/com_users/helpers/debug.php
替换：Joomla\Component\Users\Administrator\Helper\DebugHelper\UsersHelperDebug

UsersHelper​

文件：administrator/components/com_users/helpers/users.php
替换：\Joomla\Component\Users\Administrator\Helper\UsersHelper

ContactHelperRoute​

文件：components/com_contact/helpers/route.php
替换：Joomla\Component\Contact\Site\Helper\RouteHelper

FinderHelperRoute​

文件：components/com_finder/helpers/route.php
替换：Joomla\Component\Finder\Site\Helper\RouteHelper

NewsfeedsHelperRoute​

文件：components/com_newsfeeds/helpers/route.php
替换：Joomla\Component\Newsfeeds\Site\Helper\RouteHelper

TagsHelperRoute​

文件：components/com_tags/helpers/route.php
替换：Joomla\Component\Tags\Site\Helper\RouteHelper

语言字符串

文件：administrator/language/zh-CN/com_users.ini
字符串：COM_USERS_MAIL_PLEASE_FILL_IN_THE_FORM_CORRECTLY、COM_USERS_MAIL_PLEASE_FILL_IN_THE_MESSAGE、COM_USERS_MAIL_PLEASE_FILL_IN_THE_SUBJECT、COM_USERS_MAIL_PLEASE_SELECT_A_GROUP

方法弃用

计划在 Joomla 中移除！6.0

ArticlesLatestHelper static getList(Registry $params, ArticlesModel $model)​

文件：modules/mod_articles_latest/src/Helper/ArticlesLatestHelper.php 替换：$this->getArticles(Registry $params, SiteApplication $app) 示例

// Usually used in the module context which implements \Joomla\CMS\Helper\HelperFactoryAwareInterface
$articles = $this->getHelperFactory()->getHelper('ArticlesLatestHelper')->getArticles($data['params'], $this->getApplication());
ArticlesNewsHelper static getList(Registry $params, ArticlesModel $model)​

文件：modules/mod_articles_news/src/Helper/ArticlesNewsHelper.php 替换：$this->getArticles(Registry $params, SiteApplication $app) 示例

// Usually used in the module context which implements \Joomla\CMS\Helper\HelperFactoryAwareInterface
$articles = $this->getHelperFactory()->getHelper('ArticlesNewsHelper')->getArticles($data['params'], $this->getApplication());
Image createThumbs($thumbSizes, $creationMethod = self::SCALE_INSIDE, $thumbsFolder = null)​

文件：libraries/src/Image/Image.php 替换：createThumbnails($thumbSizes, $creationMethod = self::SCALE_INSIDE, $thumbsFolder = null, $useOriginalName = false) 示例

// when $useOriginalName is set to false, the filename follows the format {filename}_{width}x{height}.{ext}
$image = new Image($path);
try {
    $image->createThumbnails([$width . 'x' . $height], $image::SCALE_INSIDE, null, true);
} catch (\Exception $e) {
    return false;

#### CMSObject legacy traits

File: libraries/src/Object/CMSObject.php
Replacement: The CMSObject should be replaced by stdclass or \Joomla\Registry\Registry
Example:
```php
$data = new \stdClass();
// Or
$data = (object) ['foo' => 1, 'bar' => 2];

文件：libraries/src/Object/LegacyErrorHandlingTrait.php 替换：setError 和 getError 函数不再使用，应该引发异常。示例

throw new \Exception(...);

文件：libraries/src/Object/LegacyPropertyManagementTrait.php 替换：不再使用动态属性，以符合 PHP 8.2 中的动态属性更改 已弃用。属性应在类中声明并使用适当的 getter 和 setter。示例

class MyDataObject {
    private $foo;
    
    public function getFoo() {
        return $foo;
    }
    
    public function setFoo($foo) {
        $this->foo = $foo;
    }

}