Static Public Member Functions
static	run (int $entryPointLevel=0, int $requestType=0)

Public Attributes
const	REQUESTTYPE_FE = 1

const	REQUESTTYPE_BE = 2

const	REQUESTTYPE_CLI = 4

const	REQUESTTYPE_AJAX = 8

const	REQUESTTYPE_INSTALL = 16

Static Protected Member Functions
static	createApplicationContext ()

static	defineBaseConstants ()

static string	calculateScriptPath (int $entryPointLevel, int $requestType)

static string	calculateRootPath (int $entryPointLevel, int $requestType)

static	initializeGlobalVariables ()

static	initializeGlobalTimeTrackingVariables ()

static	getDefinedPathRoot ()

static	initializeEnvironment (int $requestType, string $scriptPath, string $sitePath)

static	isRunningOnWindows ()

static string	getPathThisScript (bool $isCli)

static string	getPathThisScriptNonCli ()

static string	getPathThisScriptCli ()

static string	getRootPathFromScriptPath ($scriptPath, $entryPointLevel)

static	usesComposerClassLoading ()

static	isCliRequestType (?int $requestType)

Detailed Description

Class to encapsulate base setup of bootstrap.

This class contains all code that must be executed by every entry script.

It sets up all basic paths, constants, global variables and checks the basic environment TYPO3 runs in.

This class does not use any TYPO3 instance specific configuration, it only sets up things based on the server environment and core code. Even with a missing system/settings.php this script will be successful.

The script aborts execution with an error message if some part fails or conditions are not met.

This script is internal code and subject to change.

Definition at line 40 of file SystemEnvironmentBuilder.php.

Member Function Documentation

◆ calculateRootPath()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::calculateRootPath	(	int	$entryPointLevel,
		int	$requestType
	)

staticprotected

Absolute path to the "classic" site root of the TYPO3 application. This semantically refers to the directory where executable server-side code, configuration and runtime files are located (e.g. typo3conf/ext, typo3/sysext, typo3temp/var). In practice this is always identical to the public web document root path which contains files that are served by the webserver directly (fileadmin/ and public resources).

This is not to be confused with the app-path that is used in composer-mode installations (by default). Resources in app-path are located outside the document root.

Parameters

int	$entryPointLevel	‪Number of subdirectories where the entry script is located under the document root
int	$requestType

Returns: ‪string Absolute path without trailing slash

Definition at line 150 of file SystemEnvironmentBuilder.php.

References TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getDefinedPathRoot(), TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getRootPathFromScriptPath(), and TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\isCliRequestType().

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\run().

◆ calculateScriptPath()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::calculateScriptPath	(	int	$entryPointLevel,
		int	$requestType
	)

staticprotected

Calculate script path. This is the absolute path to the entry script. Can be something like '.../public/index.php' for web calls, or '.../bin/typo3' or similar for cli calls.

Parameters

int $entryPointLevel ‪Number of subdirectories where the entry script is located under the document root

Returns: ‪string Absolute path to entry script

Definition at line 109 of file SystemEnvironmentBuilder.php.

References TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getDefinedPathRoot(), TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getRootPathFromScriptPath(), and TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\isCliRequestType().

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\run().

◆ createApplicationContext()

static TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::createApplicationContext ( )

staticprotected

Some notes:

HTTP_TYPO3_CONTEXT -> used with Apache suexec support REDIRECT_TYPO3_CONTEXT -> used under some circumstances when value is set in the webserver and proxying the values to FPM

Exceptions

Definition at line 78 of file SystemEnvironmentBuilder.php.

◆ defineBaseConstants()

static TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::defineBaseConstants ( )

staticprotected

Define all simple constants that have no dependency to local configuration

Definition at line 87 of file SystemEnvironmentBuilder.php.

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\run().

◆ getDefinedPathRoot()

static TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::getDefinedPathRoot ( )

staticprotected

Definition at line 189 of file SystemEnvironmentBuilder.php.

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\calculateRootPath(), TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\calculateScriptPath(), and TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\initializeEnvironment().

◆ getPathThisScript()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::getPathThisScript ( bool $isCli )

staticprotected

Calculate script path.

First step in path calculation: Goal is to find the absolute path of the entry script that was called without resolving any links. This is important since the TYPO3 entry points are often linked to a central core location, so we can not use the php magic FILE here, but resolve the called script path from given server environments.

This path is important to calculate the document root. The strategy is to find out the script name that was called in the first place and to subtract the local part from it to find the document root.

Parameters

bool $isCli

Returns: ‪string Absolute path to entry script

Definition at line 252 of file SystemEnvironmentBuilder.php.

References TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getPathThisScriptCli(), and TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getPathThisScriptNonCli().

◆ getPathThisScriptCli()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::getPathThisScriptCli ( )

staticprotected

Calculate path to entry script if in cli mode.

First argument of a cli script is the path to the script that was called. If the script does not start with / (or A:\ for Windows), the path is not absolute yet, and the current working directory is added.

Returns: ‪string Absolute path to entry script

Definition at line 282 of file SystemEnvironmentBuilder.php.

References $_SERVER.

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getPathThisScript().

◆ getPathThisScriptNonCli()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::getPathThisScriptNonCli ( )

staticprotected

Return path to entry script if not in cli mode.

Returns: ‪string Absolute path to entry script

Definition at line 265 of file SystemEnvironmentBuilder.php.

References $_SERVER, TYPO3\CMS\Core\Core\Environment\isRunningOnCgiServer(), and TYPO3\CMS\Core\Core\Environment\usesCgiFixPathInfo().

Referenced by TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getPathThisScript().

◆ getRootPathFromScriptPath()

static string TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::getRootPathFromScriptPath	(	$scriptPath,
		$entryPointLevel
	)

staticprotected

Calculate the document root part to the instance from $scriptPath. This is based on the amount of subdirectories "under" root path where $scriptPath is located.

The following main scenarios for entry points exist by default in the TYPO3 core:

‪Directly called documentRoot/index.php (-> FE call or eiD include): index.php is located in the same directory as the main project. The document root is identical to the directory the script is located at.
‪The install tool, located under typo3/install.php.
‪The CLI script 'typo3/sysext/core/bin/typo3' which is located inside typo3/ directly.

Parameters

string	$scriptPath	‪Calculated path to the entry script
int	$entryPointLevel	‪Number of subdirectories where the entry script is located under the document root