Attention

TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore.

You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.

The "tce_db.php" API

This script is a gateway for POST forms to class \TYPO3\CMS\Core\DataHandling\DataHandler. It has historically been the script to which data was posted when you wanted to update something in the database.

Today it is used for editing by only a few scripts, actually only the "Quick Edit" module in "Web>Page" (frontend). The standard forms you find in TYPO3 are normally rendered and handled by alt_doc.php which includes \TYPO3\CMS\Core\DataHandling\DataHandler on its own.

For commands it is still used from various locations.

You can send data to this file either as GET or POST vars where POST takes precedence. The variable names you can use are:

GP var name

Data type

Description

data

array

Data array on the form [tablename][uid][fieldname] = value.

Typically it comes from a POST form which submits a form field like <input name="data[tt_content][123][header]" value="This is the headline" />.

cmd

array

Command array on the form [tablename][uid][command] = value. This array may get additional data set internally based on clipboard commands send in CB var!

Typically this comes from GET vars passed to the script like &cmd[tt\_content][123][delete]=1 which will delete Content Element with UID 123.

cacheCmd

string

Cache command sent to ->clear_cacheCmd

redirect

string

Redirect URL. Script will redirect to this location after performing operations (unless errors has occurred)

flags

array

Accepts options to be set in TCE object. Currently it supports "reverseOrder" (boolean).

mirror

array

Example: [mirror][table][11] = '22,33' will look for content in [data][table][11] and copy it to [data][table][22] and [data][table][33].

prErr

boolean

If set, errors will be printed on screen instead of redirection. Should always be used, otherwise you will see no errors if they happen.

CB

array

Clipboard command array. May trigger changes in "cmd".

vC

string

Verification code

uPT

string

Update Page Tree Trigger. If set and the manipulated records are pages then the update page tree signal will be set.