Attention

TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.

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.