如何配置TYPO3 Form完成器实现外部URL跳转？解决number报错

错误原因说明 #

你遇到的“要求输入number”提示，是因为默认的重定向完成器（Redirect Finisher） 只支持填写TYPO3系统内页面的UID（数字ID），而非直接输入URL。它的核心逻辑是关联站内页面，所以参数类型被限定为整数，直接输入网址字符串就会触发类型验证错误。

解决方法分两种场景： #

场景1：重定向到TYPO3内部页面

• 打开表单编辑器，进入「完成器（Finishers）」板块，添加「重定向完成器」
• 在「页面UID（Page UID）」字段，填入目标页面的数字ID（比如感谢页面的UID是123，就直接填123）
• 保存配置后测试表单提交，即可正常跳转至指定站内页面

场景2：重定向到外部URL

默认重定向完成器不支持直接填写外部网址，可通过以下两种方式实现：

方式1：自定义PHP完成器

创建一个简单的完成器类，放在你的扩展目录下：

<?php
namespace Vendor\YourExtension\Finishers;

use TYPO3\CMS\Form\Domain\Finishers\AbstractFinisher;
use TYPO3\CMS\Core\Http\RedirectResponse;

class ExternalRedirectFinisher extends AbstractFinisher
{
    protected function executeInternal()
    {
        $targetUrl = $this->parseOption('targetUrl');
        if (!empty($targetUrl)) {
            $this->finisherContext->getResponse()->setResponse(new RedirectResponse($targetUrl));
        }
    }
}

然后在表单的YAML配置中注册并使用该完成器：

finishers:
  -
    identifier: 'Vendor\YourExtension\Finishers\ExternalRedirectFinisher'
    options:
      targetUrl: 'https://example.com/thank-you'

方式2：使用内置「自定义代码完成器」

无需编写类文件，直接在表单编辑器中添加「自定义代码完成器」，在代码输入框中填入：

$targetUrl = 'https://example.com/thank-you';
$GLOBALS['TYPO3_RESPONSE'] = new \TYPO3\CMS\Core\Http\RedirectResponse($targetUrl);

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