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.

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

select

This object generates an SQL-select statement to select records from the database.

Some records are hidden or timed by start- and end-times. This is automatically added to the SQL-select by looking for "enablefields" in the $GLOBALS['TCA'].

Warning

Do not use GET or POST data like GPvar directly with this object! Avoid SQL injections! Don't trust any external data! Sanitize your input first!

Comprehensive example

See PHP source code for:

  • ContentObjectRenderer (full namespace: \TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer)

  • ContentObjectRenderer::getQuery()

  • ContentObjectRenderer::getWhere()

Condensed form:

10 = CONTENT
10 {
   table =
   select {
      uidInList =
      pidInList =
      recursive =
      orderBy =
      groupBy =
      max =
      begin =
      where =
      languageField =
      includeRecordsWithoutDefaultTranslation =
      selectFields =
      join =
      leftjoin =
      rightjoin =
   }
}

uidInList

Property

uidInList

Data type

list of record_ids /stdWrap

Description

Comma-separated list of record uids from the according database table. For example when the select function works on the table tt_content, then this will be uids of tt_content records.

Note: this is a special keyword and replaced with the id of the current record.

Examples

select.uidInList = 1,2,3
select.uidInList = this

pidInList

Property

pidInList

Data type

list of page_ids /stdWrap

Description

Comma-separated list of pids of the record. This will be page_ids. For example when the select function works on the table tt_content, then this will be pids of tt_content records, the parent pages of these records.

Pages in the list, which are not visible for the website user, are automatically removed from the list. Thereby no records from hidden, timed or access-protected pages will be selected! Nor will be records from recyclers.

Special keyword: "this" is replaced with the id of the current page.

Special keyword: "root" allows to select records from the root-page level (records with pid=0, e.g. useful for the table "sys_category" and others).

Special value: "-1" allows to select versioned records in workspaces directly.

Example

Fetch related sys_category records stored in the MM intermediate table:

10 = CONTENT
10 {
   table = sys_category
   select {
      pidInList = root,-1
      selectFields = sys_category.*
      join = sys_category_record_mm ON sys_category_record_mm.uid_local = sys_category.uid
      where.data = field:_ORIG_uid // field:uid
      where.intval = 1
      where.wrap = sys_category_record_mm.uid_foreign=|
      orderBy = sys_category_record_mm.sorting_foreign
      languageField = 0 # disable translation handling of sys_category
   }
}

Default

this

recursive

Property

recursive

Data type

integer /stdWrap

Description

Number of recursivity levels for the pidInList.

Default

0

orderBy

Property

orderBy

Data type

SQL-orderBy /stdWrap

Description

ORDER BY clause without the words "ORDER BY".

Example:

orderBy = sorting, title

groupBy

Property

groupBy

Data type

SQL-groupBy /stdWrap

Description

GROUP BY clause without the words "GROUP BY".

Example:

groupBy = CType

max

Property

max

Data type

integer +calc +"total" /stdWrap

Description

Max records

Special keyword: "total" is substituted with count(*).

begin

Property

begin

Data type

integer +calc +"total" /stdWrap

Description

Begin with record number value.

Special keyword: "total" is substituted with count(*).

where

Property

where

Data type

SQL-where /stdWrap

Description

WHERE clause without the word "WHERE".

Example:

where = (title LIKE '%SOMETHING%' AND NOT doktype)

languageField

Property

languageField

Data type

string /stdWrap

Description

By default all records that have language-relevant information in the TCA "ctrl"-section are translated on translated pages.

This can be disabled by setting languageField = 0.

includeRecordsWithoutDefaultTranslation

Property

includeRecordsWithoutDefaultTranslation

Data type

boolean /stdWrap

Description

If content language overlay is activated and the option "languageField" is not disabled, includeRecordsWithoutDefaultTranslation allows to additionally fetch records, which do not have a parent in the default language.

Default

0

selectFields

Property

selectFields

Data type

string /stdWrap

Description

List of fields to select, or "count(*)".

If the records need to be localized, please include the relevant localization-fields (uid, pid, languageField and transOrigPointerField). Otherwise the TYPO3 internal localization will not succeed.

Default

*

join, leftjoin, rightjoin

Property

join, leftjoin, rightjoin

Data type

string /stdWrap

Description

Enter the table name for JOIN, LEFT OUTER JOIN and RIGHT OUTER JOIN respectively.

markers

Property

markers

Data type

(array of markers)

Description

The markers defined in this section can be used, wrapped in the usual ###markername### way, in any other property of select. Each value is properly escaped and quoted to prevent SQL injection problems. This provides a way to safely use external data (e.g. database fields, GET/POST parameters) in a query.

Available sub-properties:

<markername>.value: (value)

Sets the value directly.

<markername>.commaSeparatedList: (boolean)

If set, the value is interpreted as a comma-separated list of values. Each value in the list is individually escaped and quoted.

(stdWrap properties ...)

All stdWrap properties can be used for each markername.

Warning

Since TYPO3 8 there is a problem combining orderBy with markers caused by the quoting of the fields, see forge#87799.

Example:

page.60 = CONTENT
page.60 {
  table = tt_content
  select {
    pidInList = 73
    where = header != ###whatever###
    markers {
      whatever.data = GP:first
    }
  }
}

This example selects all records from table tt_content, which are on page 73 and which don't have the header set to the value provided by the Get/Post variable "first".

page.60 = CONTENT
page.60 {
      table = tt_content
      select {
         pidInList = 73
         where = header != ###whatever###
         markers {
            whatever.value = some
            whatever.wrap = |thing
         }
      }
}

This examples selects all records from the table tt_content which are on page 73 and which don't have a header set to a value constructed by whatever.value and whatever.wrap ('something').