如何从外部文件实例化Joomla! 5.2框架？求助

我之前在Joomla! 3中实现过通过AJAX调用返回模块内容的功能——先实例化Joomla!框架，再渲染并返回模块。但现在在Joomla! 5.2中，我没法成功完成框架实例化：一开始语言未设置，手动加载语言后，又遇到了Template Component相关的问题。求各位提供解决建议。

以下是我尝试的代码：

defined('_JEXEC') or die;

use Joomla\CMS\Factory;
use Joomla\CMS\Application\SiteApplication;
use Joomla\Session\SessionInterface;

if (!defined('JPATH_BASE')) {
    define('JPATH_BASE', '/home/myinstallation'); // Joomla根目录路径
}


require_once JPATH_BASE . '/includes/defines.php';
require_once JPATH_BASE . '/includes/framework.php';

try {
    // 获取DI容器
    $container = Factory::getContainer();

    // 注册会话别名
    if (!$container->has(SessionInterface::class)) {
        $container->alias(SessionInterface::class, 'session.web.site');
    }

    // 获取站点应用实例
    $app = $container->get(SiteApplication::class);
    Factory::$application = $app;

    // 启动会话
    $session = $app->getSession();
    if (!$session->isActive()) {
        $session->start();
    }

    // 获取菜单对象
    $input = $app->input; 
    $menu = $app->getMenu();

    // 设置默认菜单项为激活状态
    $defaultMenuItem = $menu->getDefault();
    if ($defaultMenuItem !== null) {
        $menu->setActive($defaultMenuItem->id);
    } else {
        echo "无法找到默认菜单项。" . PHP_EOL;
    }

    // 手动实例化语言对象
    $language = new Joomla\CMS\Language\Language('en-EN', JPATH_BASE);

    // 加载核心语言文件
    $loaded = $language->load('joomla', JPATH_BASE, 'en-EN');
    if (!$loaded) {
        throw new \RuntimeException("无法加载语言文件。");
    }

    // 为应用设置语言
    Factory::$application->loadLanguage($language);

    // 调试输出
    echo '语言加载成功: ' . $language->getTag() . PHP_EOL;

} catch (\Exception $e) {
    die('启动Joomla时出错: ' . $e->getMessage());
}

解决建议 #

• 使用官方初始化方法替代手动配置：Joomla 5的SiteApplication内置initialise()方法，能自动完成语言、会话、菜单等核心组件的初始化流程，无需手动创建Language实例。替换手动语言处理代码为：

  // 初始化应用，指定语言标签
  $app->initialise(['language' => 'en-EN']);
  

• 正确绑定应用实例：不要直接赋值Factory::$application，改用官方推荐的Factory::setApplication($app)方法，确保DI容器与Factory的状态一致。
• 初始化文档服务：模板组件报错通常是因为文档对象未正确初始化，可添加以下代码注册并设置HTML文档：

  $document = $container->get(\Joomla\CMS\Document\HtmlDocument::class);
  $app->setDocument($document);
  

• 简化容器服务操作：Joomla 5的DI容器默认已注册SessionInterface等核心服务，除非有特殊定制需求，无需手动添加别名。
• 验证路径与权限：确认JPATH_BASE指向的Joomla根目录绝对路径正确，执行脚本的用户拥有读取includes目录、语言文件的权限。

内容的提问来源于stack exchange，提问作者Alex