如何在TYPO3的pages表添加strip_tags(title)计算字段

直接按以下步骤实现即可，不需要纠结passthrough、user类型或者自定义eval，下面的方案兼容后台编辑、接口写入、批量操作全场景，不会漏数据。

方案选型说明 #

先把你纠结的几个选项的问题说清楚，避免走弯路：

• 不选passthrough类型：该类型字段不会被DataHandler纳入持久化流程，也不会被核心搜索逻辑识别，配置到searchFields里无法生效
• 不选user类型：该类型主要用于后台表单自定义渲染，作为纯存储字段使用会产生不必要的渲染开销，性能差
• 不选带自定义eval的input类型：核心evaluateFieldValue()方法仅接收当前字段自身的值、字段配置等参数，无法获取同条记录下title字段的内容，没法完成跨字段取值计算

最优选择是：新增持久化数据库字段 + 配置隐藏input类型TCA + DataHandler钩子自动填充计算值

具体实现步骤 #

1. 新增数据库字段 #

在你的sitepackage或者自定义扩展的ext_tables.sql文件中添加字段定义，注意TYPO3数据库字段遵循小写下划线命名规范，不要用驼峰命名：

CREATE TABLE pages (
    title_tag_stripped text DEFAULT '' NOT NULL
);

写完后去后台扩展模块点一下对应扩展的「分析数据库」，执行字段新增操作即可。

2. 配置TCA #

在扩展的Configuration/TCA/Overrides/pages.php文件中添加字段配置，同时把字段加入核心搜索字段列表：

<?php
defined('TYPO3') || die();

// 配置隐藏存储字段
$GLOBALS['TCA']['pages']['columns']['title_tag_stripped'] = [
    'config' => [
        'type' => 'input',
        'renderType' => 'hidden',
    ],
];

// 追加到搜索字段配置
$GLOBALS['TCA']['pages']['ctrl']['searchFields'] .= ',title_tag_stripped';

3. 注册钩子自动填充计算值 #

通过DataHandler的保存钩子实现：只要pages记录发生新增/更新操作，自动取title字段值剥离HTML后存入title_tag_stripped字段，所有写入场景都会触发该逻辑。
首先在扩展的ext_localconf.php中注册钩子：

<?php
defined('TYPO3') || die();

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamap_postProcessFieldArray']['your_ext_key'] =
    \Vendor\YourExtKey\Hooks\DataHandler\PopulateStrippedTitleHook::class;

然后新建钩子类，路径为Classes/Hooks/DataHandler/PopulateStrippedTitleHook.php：

<?php
declare(strict_types=1);
namespace Vendor\YourExtKey\Hooks\DataHandler;

use TYPO3\CMS\Core\DataHandling\DataHandler;

class PopulateStrippedTitleHook
{
    public function processDatamap_postProcessFieldArray(
        string $status,
        string $table,
        $id,
        array &$fieldArray,
        DataHandler $parentObject
    ): void {
        if ($table !== 'pages') {
            return;
        }

        // 本次写入包含title字段时，重新计算剥离HTML后的值
        if (isset($fieldArray['title'])) {
            $fieldArray['title_tag_stripped'] = strip_tags($fieldArray['title']);
        }

        // 新建记录时兜底处理
        if ($status === 'new' && !isset($fieldArray['title_tag_stripped'])) {
            $fieldArray['title_tag_stripped'] = strip_tags($fieldArray['title'] ?? '');
        }
    }
}

注意把代码里的Vendor\YourExtKey替换成你自己扩展的命名空间即可。

4. 补全历史数据 #

上述逻辑只对新增/更新的记录生效，存量历史数据可以通过两种方式补全：

• 去后台「系统」->「DB check」模块，选择批量更新pages表，批量重算一次字段值
• 写简单的CLI脚本遍历所有pages记录，取title字段做strip_tags后更新到对应字段即可

注意：不要直接修改原生title字段的存储逻辑，保留带HTML的title用于前台渲染，单独存纯文本字段做搜索匹配，既不影响原有页面展示，还能避免HTML标签干扰搜索匹配准确率。

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