Appendix A – PHP include scripts¶
Including your script¶
This section should give you some pointers on what you can process in your script and which functions and variables you can access.
Your script is included inside the class
\TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer
in the
EXT:frontend/Classes/ContentObject/ContentObjectRenderer.php (GitHub)
script. Thereby your file is a part of this object
(ContentObjectRenderer
). This is why you must return all
content in the variable $content
and any TypoScript configuration is
available from the array $conf
(it may not be set at all though, so
check it with is_array()
)
$content¶
Contains the content, which was passed to the object, if any. All content, which you want to return, must be in this variable.
Do not output anything directly in your script.
$conf¶
The array $conf
contains the configuration for the USER cObject.
Try debug($conf)
to see the content printed out for debugging!
White spaces¶
Because nothing is sent off to the browser before everything is
rendered and returned to \TYPO3\CMS\Frontend\Http\RequestHandler
(which originally set off the rendering process), you must ensure
that there's no whitespace before your <?php
tag
in your include or library scripts! You should not use the closing PHP tag
?>
.
$GLOBALS['TSFE']->set_no_cache()¶
Call the function $GLOBALS['TSFE']->set_no_cache()
, if you want to
disable caching of the page. Call this during development only! And
call it, if the content you create may not be cached.
Note
If you make a syntax error in your script that keeps PHP
from executing it, then the $GLOBALS['TSFE']->set_no_cache()
function is not executed and the page is cached! So in these
situations, correct the error, clear the page-cache and try again.
This is true only for USER
and not for USER_INT
, which is
rendered after the cached page!
Example:¶
$GLOBALS['TSFE']->set_no_cache();
ContentObjectRenderer::cObjGetSingle(value, properties[, TSkey = '__'])
¶
A method of TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer
.
Gets a content object from the $conf
array.
Example:¶
$content = $cObjectRenderer->cObjGetSingle($conf['image'], $conf['image.'], 'My Image 2');
This would return any IMAGE cObject at the property image
of the
$conf
array for the include script!
ContentObjectRenderer::stdWrap(value, properties)
¶
A method of TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer
.
Hands the content in "value" to the stdWrap function, which will process it according to the configuration of the array "properties".
Example:¶
$content = $cObjectRenderer->stdWrap($content, $conf['stdWrap.']);
This will stdWrap the content with the properties of .stdWrap
of the
$conf
array!
Internal variables in the main frontend object, TSFE¶
There are some variables in the global object, TSFE (TypoScript
Frontend), you might need to know about. These ARE ALL READ-ONLY!
(Read: Do not change them!) See the class
\TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController
for the
full descriptions.
You can retrieve the TypoScriptFrontendController
via the
request attribute
frontend.controller.
For instance, if you want to access the variable id
, you can do so by
writing: TypoScriptFrontendController->id
.
TypoScriptFrontendController->id¶
Changed in version 13.0
The property has been marked as read-only. Use
$request->getAttribute('frontend.page.information')->getId()
instead. See Frontend page information.
-
id
¶ -
- Type
- integer
The current page id
TypoScriptFrontendController->type¶
Changed in version 13.0
The property has been removed with TYPO3 v13.0. See Migration
-
type
¶ -
- Type
- integer
Migration from $GLOBALS['TSFE']->type
¶
When using this property in PHP code via $GLOBALS['TSFE']->type
,
it is recommended to move to the
PSR-7 request via
$request->getAttribute('routing')->getPageType()
.
TypoScriptFrontendController->page¶
Changed in version 13.0
The property has been marked as read-only. Use
$request->getAttribute('frontend.page.information')->getPageRecord()
instead. See Frontend page information.
-
page
¶ -
- Type
- array
The page record
TypoScriptFrontendController->feuser¶
Changed in version 13.0
The variable has been removed with TYPO3 v13. See Migration
-
fe_user
¶ -
- Type
- array
The frontend user record
Migration: Use UserAspect or context instead of $GLOBALS['TSFE']->fe_user
¶
There are two possible migrations.
First, a limited information list of frontend user details can be
retrieved using the Context aspect
frontend.user
in frontend calls. See class
\TYPO3\CMS\Core\Context\UserAspect
for a full list. The current
context can be retrieved using
dependency injection.
Example:
use TYPO3\CMS\Core\Context\Context;
final class MyExtensionController {
public function __construct(
private readonly Context $context,
) {}
public function myAction() {
$frontendUserUsername = $this->context->getPropertyFromAspect(
'frontend.user',
'username',
''
);
}
}
Additionally, the full \TYPO3\CMS\Frontend\Authentication\FrontendUserAuthentication
object is available as request attribute
frontend.user
in the frontend. Note some details of that object are marked
@internal
, using the context aspect is thus the preferred way.
Example of an extension using the Extbase's ActionController
:
final class MyExtensionController extends ActionController {
public function myAction() {
// Note the 'user' property is marked @internal.
$frontendUserUsername = $this->request
->getAttribute('frontend.user')->user['username'];
}
}
TypoScriptFrontendController->rootLine¶
Changed in version 13.0
The property has been marked as read-only. Use
$request->getAttribute('frontend.page.information')->getRootLine()
instead. See Frontend page information.
-
rootLine
¶ -
- Type
- array
The root line (all the way to tree root, not only the current site!).
The current site root line is available via
$request->getAttribute('frontend.page.information')->getLocalRootLine()
. See Frontend page information.In TYPO3 versions before v13 the current site root line was only available via
\TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->config['rootLine']
.
TypoScriptFrontendController->table-row¶
Changed in version 13.0
The property has been marked as read-only. Avoid usages altogether,
create own instances of the
\TYPO3\CMS\Core\Domain\Repository\PageRepository
when needed.
-
rootLine
¶ -
- Type
- object
The object with page functions (object) See
EXT:core/Classes/Domain/Repository/PageRepository.php
.
Global variables¶
$GLOBAL['BE_USER']
¶
-
$GLOBAL['BE_USER']
¶ -
- Type
- object
The backend user object. See Backend user object for more information.
$GLOBAL['TYPO3_CONF_VARS']
¶
-
$GLOBAL['TYPO3_CONF_VARS']
¶ -
- Type
- object
TYPO3 configuration variables. See TYPO3_CONF_VARS for more information.
$GLOBAL['TYPO3_CONF_VARS']
¶
-
$GLOBAL['TSFE']
¶ -
- Type
- object
Main frontend object. Whenever possible, use the request attribute frontend.controller instead. See also TSFE.