如何使用TYPO3 QueryBuilder实现双表UPDATE SQL迁移语句？

我明白你想用TYPO3的QueryBuilder来实现这个跨表更新的需求——原生SQL写起来很直接，但QueryBuilder基于Doctrine DBAL，在处理UPDATE JOIN的时候有特定的语法要求，咱们一步步来搞定它。

完整的QueryBuilder实现代码 #

use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\Utility\GeneralUtility;

// 获取对应表的QueryBuilder实例
$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('table1');

// 移除TYPO3默认的查询限制（比如隐藏已删除记录的限制），确保迁移能正常执行
$queryBuilder->getRestrictions()->removeAll();

// 构建跨表更新语句
$queryBuilder
    ->update('table1', 't1') // 给table1指定别名t1
    ->innerJoin(
        't1',
        'table2',
        't2',
        // 构建关联条件：t1.uid = t2.uid
        $queryBuilder->expr()->eq('t1.uid', $queryBuilder->quoteIdentifier('t2.uid'))
    )
    // 将t2.field2的值赋值给t1.field1，注意用quoteIdentifier包裹字段名
    ->set('t1.field1', $queryBuilder->quoteIdentifier('t2.field2'));

// 执行更新操作，返回受影响的行数
$affectedRows = $queryBuilder->executeStatement();

关键细节说明 #

• 移除查询限制：TYPO3默认会给QueryBuilder添加DeletedRestriction等规则，如果你的迁移需要操作所有记录（包括已删除的），必须调用getRestrictions()->removeAll()，否则会导致更新范围不符合预期。
• 别名与关联写法：在update()方法中直接指定主表别名，然后通过innerJoin（如果需要左连接可以用leftJoin）关联副表，关联条件用QueryBuilder的expr()方法构建，保证语法兼容不同数据库。
• 字段引用的正确方式：当把副表字段的值赋给主表字段时，必须用quoteIdentifier()包裹副表字段名，否则QueryBuilder会把t2.field2解析为字符串常量，而不是字段引用，这也是很多人踩坑的点。
• 执行语句：使用executeStatement()执行更新，这个方法会返回受影响的行数，你可以根据这个值判断更新是否成功执行。

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