TYPO3 9.5中Extbase控制器如何替代addAdditionalHeaderData添加头部数据

嘿，这个问题我升级TYPO3 9.5的时候也踩过坑！原来的addAdditionalHeaderData()方法在TYPO3 9+版本里确实被移除了，官方改用了更规范的资源管理方式，下面给你两种常用的实现方案：

方案一：使用PageRenderer（推荐用于添加前端资源） #

TYPO3 9+推荐通过PageRenderer来管理页面的JS、CSS等前端资源，这也是最贴近你原有需求的方式。

步骤1：在控制器中注入PageRenderer #

首先需要在你的控制器里注入PageRenderer实例：

use TYPO3\CMS\Core\Page\PageRenderer;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;

class YourCustomController extends ActionController
{
    /**
     * @var PageRenderer
     */
    protected $pageRenderer;

    /**
     * 注入PageRenderer
     * @param PageRenderer $pageRenderer
     */
    public function injectPageRenderer(PageRenderer $pageRenderer)
    {
        $this->pageRenderer = $pageRenderer;
    }
}

步骤2：在Action中添加脚本资源 #

如果是添加外部JS文件，直接用addJsFile方法，参数可以灵活配置加载位置、依赖等：

public function yourAction()
{
    $scriptPath = 'path/to/your/script.js';
    
    // 添加外部JS文件到页面头部
    $this->pageRenderer->addJsFile(
        $scriptPath,
        'text/javascript',
        true, // 设置为true表示在页面头部加载，false则在尾部
        false,
        '',
        false,
        '',
        true
    );

    // 如果是要添加自定义的HTML头部代码（比如内联脚本或其他标签），用addHeaderData
    // $this->pageRenderer->addHeaderData('<script src="' . $scriptPath . '" type="text/javascript"></script>');
}

方案二：使用PSR-7 Response对象（用于添加HTTP头部） #

如果你的需求是添加HTTP响应头部（而非前端资源），可以用TYPO3 9+引入的PSR-7规范响应对象：

use Psr\Http\Message\ResponseInterface;
use TYPO3\CMS\Core\Http\ResponseFactory;

class YourCustomController extends ActionController
{
    /**
     * @var ResponseFactory
     */
    protected $responseFactory;

    /**
     * @param ResponseFactory $responseFactory
     */
    public function injectResponseFactory(ResponseFactory $responseFactory)
    {
        $this->responseFactory = $responseFactory;
    }

    public function yourAction(): ResponseInterface
    {
        // 创建响应对象并添加自定义HTTP头部
        $response = $this->responseFactory->createResponse();
        return $response->withHeader('X-Custom-Header', 'your-custom-value');
    }
}

补充说明 #

TYPO3 9.5开始全面引入PSR-7规范，原来的Extbase Response对象的很多旧方法被废弃，官方推荐使用PageRenderer来管理前端页面资源，这样也能更好地和TYPO3的资源合并、压缩机制兼容。

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