[TASK][CONF] Accept other settings in [SYS][setDBinit]
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Classes / Core / Bootstrap.php
1 <?php
2 namespace TYPO3\CMS\Core\Core;
3
4 /***************************************************************
5 * Copyright notice
6 *
7 * (c) 2012-2013 Christian Kuhn <lolli@schwarzbu.ch>
8 * All rights reserved
9 *
10 * This script is part of the TYPO3 project. The TYPO3 project is
11 * free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
15 *
16 * The GNU General Public License can be found at
17 * http://www.gnu.org/copyleft/gpl.html.
18 * A copy is found in the text file GPL.txt and important notices to the license
19 * from the author is found in LICENSE.txt distributed with these scripts.
20 *
21 *
22 * This script is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU General Public License for more details.
26 *
27 * This copyright notice MUST APPEAR in all copies of the script!
28 ***************************************************************/
29
30 use TYPO3\CMS\Core\Utility;
31
32 require_once __DIR__ . '/SystemEnvironmentBuilder.php';
33
34 /**
35 * This class encapsulates bootstrap related methods.
36 * It is required directly as the very first thing in entry scripts and
37 * used to define all base things like constants and pathes and so on.
38 *
39 * Most methods in this class have dependencies to each other. They can
40 * not be called in arbitrary order. The methods are ordered top down, so
41 * a method at the beginning has lower dependencies than a method further
42 * down. Do not fiddle with the load order in own scripts except you know
43 * exactly what you are doing!
44 *
45 * @author Christian Kuhn <lolli@schwarzbu.ch>
46 */
47 class Bootstrap {
48
49 /**
50 * @var \TYPO3\CMS\Core\Core\Bootstrap
51 */
52 static protected $instance = NULL;
53
54 /**
55 * Unique Request ID
56 *
57 * @var string
58 */
59 protected $requestId;
60
61 /**
62 * The application context
63 *
64 * @var \TYPO3\CMS\Core\Core\ApplicationContext
65 */
66 protected $applicationContext;
67
68 /**
69 * @var array List of early instances
70 */
71 protected $earlyInstances = array();
72
73 /**
74 * @var string Path to install tool
75 */
76 protected $installToolPath;
77
78 /**
79 * Disable direct creation of this object.
80 * Set unique requestId and the application context
81 *
82 * @var string Application context
83 */
84 protected function __construct($applicationContext) {
85 $this->requestId = uniqid();
86 $this->applicationContext = new ApplicationContext($applicationContext);
87 }
88
89 /**
90 * Disable direct cloning of this object.
91 */
92 protected function __clone() {
93
94 }
95
96 /**
97 * Return 'this' as singleton
98 *
99 * @return Bootstrap
100 * @internal This is not a public API method, do not use in own extensions
101 */
102 static public function getInstance() {
103 if (is_null(static::$instance)) {
104 require_once(__DIR__ . '/../Exception.php');
105 require_once(__DIR__ . '/ApplicationContext.php');
106 $applicationContext = trim(getenv('TYPO3_CONTEXT'), '"\' ') ? : 'Production';
107 self::$instance = new static($applicationContext);
108 // Establish an alias for Flow/Package interoperability
109 class_alias(get_class(static::$instance), 'TYPO3\\Flow\\Core\\Bootstrap');
110 }
111 return static::$instance;
112 }
113
114 /**
115 * Gets the request's unique ID
116 *
117 * @return string Unique request ID
118 * @internal This is not a public API method, do not use in own extensions
119 */
120 public function getRequestId() {
121 return $this->requestId;
122 }
123
124 /**
125 * Returns the application context this bootstrap was started in.
126 *
127 * @return \TYPO3\CMS\Core\Core\ApplicationContext The application context encapsulated in an object
128 * @internal This is not a public API method, do not use in own extensions.
129 * Use \TYPO3\CMS\Core\Utility\GeneralUtility::getApplicationContext() instead
130 */
131 public function getApplicationContext() {
132 return $this->applicationContext;
133 }
134
135 /**
136 * Prevent any unwanted output that may corrupt AJAX/compression.
137 * This does not interfere with "die()" or "echo"+"exit()" messages!
138 *
139 * @return Bootstrap
140 * @internal This is not a public API method, do not use in own extensions
141 */
142 public function startOutputBuffering() {
143 ob_start();
144 return $this;
145 }
146
147 /**
148 * Run the base setup that checks server environment,
149 * determines pathes, populates base files and sets common configuration.
150 *
151 * Script execution will be aborted if something fails here.
152 *
153 * @param string $relativePathPart Relative path of the entry script back to document root
154 * @return Bootstrap
155 * @internal This is not a public API method, do not use in own extensions
156 */
157 public function baseSetup($relativePathPart = '') {
158 \TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::run($relativePathPart);
159 Utility\GeneralUtility::presetApplicationContext($this->applicationContext);
160 return $this;
161 }
162
163 /**
164 * Redirect to install tool if LocalConfiguration.php is missing.
165 *
166 * @param string $pathUpToDocumentRoot Can contain eg. '../' if called from a sub directory
167 * @return Bootstrap
168 * @internal This is not a public API method, do not use in own extensions
169 */
170 public function redirectToInstallerIfEssentialConfigurationDoesNotExist($pathUpToDocumentRoot = '') {
171 $configurationManager = new \TYPO3\CMS\Core\Configuration\ConfigurationManager;
172 if (!file_exists($configurationManager->getLocalConfigurationFileLocation()) || !file_exists(PATH_typo3conf . 'PackageStates.php')) {
173 require_once __DIR__ . '/../Utility/HttpUtility.php';
174 Utility\HttpUtility::redirect($pathUpToDocumentRoot . 'typo3/sysext/install/Start/Install.php');
175 }
176 return $this;
177 }
178
179 /**
180 * Registers the instance of the specified object for an early boot stage.
181 * On finalizing the Object Manager initialization, all those instances will
182 * be transferred to the Object Manager's registry.
183 *
184 * @param string $objectName Object name, as later used by the Object Manager
185 * @param object $instance The instance to register
186 * @return void
187 */
188 public function setEarlyInstance($objectName, $instance) {
189 $this->earlyInstances[$objectName] = $instance;
190 }
191
192 /**
193 * Returns an instance which was registered earlier through setEarlyInstance()
194 *
195 * @param string $objectName Object name of the registered instance
196 * @return object
197 * @throws \TYPO3\CMS\Core\Exception
198 */
199 public function getEarlyInstance($objectName) {
200 if (!isset($this->earlyInstances[$objectName])) {
201 throw new \TYPO3\CMS\Core\Exception('Unknown early instance "' . $objectName . '"', 1365167380);
202 }
203 return $this->earlyInstances[$objectName];
204 }
205
206 /**
207 * Returns all registered early instances indexed by object name
208 *
209 * @return array
210 */
211 public function getEarlyInstances() {
212 return $this->earlyInstances;
213 }
214
215 /**
216 * Includes LocalConfiguration.php and sets several
217 * global settings depending on configuration.
218 *
219 * @param boolean $allowCaching Whether to allow caching - affects cache_core (autoloader)
220 * @param string $packageManagerClassName Define an alternative package manager implementation (usually for the installer)
221 * @return Bootstrap
222 * @internal This is not a public API method, do not use in own extensions
223 */
224 public function loadConfigurationAndInitialize($allowCaching = TRUE, $packageManagerClassName = 'TYPO3\\CMS\\Core\\Package\\PackageManager') {
225 $this
226 ->initializeClassLoader()
227 ->populateLocalConfiguration()
228 ->initializeCachingFramework()
229 ->initializeClassLoaderCaches()
230 ->initializePackageManagement($packageManagerClassName)
231 ->initializeRuntimeActivatedPackagesFromConfiguration();
232
233 // @TODO dig into this
234 if (!$allowCaching) {
235 $this->setCoreCacheToNullBackend();
236 }
237
238 $this->defineDatabaseConstants()
239 ->defineUserAgentConstant()
240 ->registerExtDirectComponents()
241 ->transferDeprecatedCurlSettings()
242 ->setCacheHashOptions()
243 ->setDefaultTimezone()
244 ->initializeL10nLocales()
245 ->convertPageNotFoundHandlingToBoolean()
246 ->registerGlobalDebugFunctions()
247 // SwiftMailerAdapter is
248 // @deprecated since 6.1, will be removed two versions later - will be removed together with \TYPO3\CMS\Core\Utility\MailUtility::mail()
249 ->registerSwiftMailer()
250 ->configureExceptionHandling()
251 ->setMemoryLimit()
252 ->defineTypo3RequestTypes();
253 return $this;
254 }
255
256 /**
257 * Initializes the Class Loader
258 *
259 * @return Bootstrap
260 */
261 protected function initializeClassLoader() {
262 $classLoader = new ClassLoader($this->applicationContext);
263 $this->setEarlyInstance('TYPO3\\CMS\\Core\\Core\\ClassLoader', $classLoader);
264 $classLoader->setRuntimeClassLoadingInformationFromAutoloadRegistry((array) include __DIR__ . '/../../ext_autoload.php');
265 $classAliasMap = new \TYPO3\CMS\Core\Core\ClassAliasMap();
266 $classAliasMap->injectClassLoader($classLoader);
267 $this->setEarlyInstance('TYPO3\\CMS\\Core\\Core\\ClassAliasMap', $classAliasMap);
268 $classLoader->injectClassAliasMap($classAliasMap);
269 spl_autoload_register(array($classLoader, 'loadClass'), TRUE, TRUE);
270 return $this;
271 }
272
273 /**
274 * Reinitializes the class loader during clear cache actions
275 * Beware! This is not public API and necessary for edge cases in the install tool
276 *
277 * @param string $packageManagerClassName
278 * @return void
279 */
280 public function reinitializeClassLoaderAndCachesAndPackageManagement($packageManagerClassName = 'TYPO3\\CMS\\Core\\Package\\PackageManager') {
281 $currentClassLoader = $this->getEarlyInstance('TYPO3\\CMS\\Core\\Core\\ClassLoader');
282 spl_autoload_unregister(array($currentClassLoader, 'loadClass'));
283 \TYPO3\CMS\Core\Cache\Cache::flagCachingFrameworkForReinitialization();
284 $this
285 ->initializeClassLoader()
286 ->populateLocalConfiguration()
287 ->initializeCachingFramework()
288 ->initializeClassLoaderCaches()
289 ->initializePackageManagement($packageManagerClassName);
290 }
291
292 /**
293 * Initialize class loader cache.
294 *
295 * @return Bootstrap
296 */
297 protected function initializeClassLoaderCaches() {
298 /** @var $classLoader ClassLoader */
299 $classLoader = $this->getEarlyInstance('TYPO3\\CMS\\Core\\Core\\ClassLoader');
300 $classLoader->injectCoreCache($this->getEarlyInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager')->getCache('cache_core'));
301 $classLoader->injectClassesCache($this->getEarlyInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager')->getCache('cache_classes'));
302 return $this;
303 }
304
305 /**
306 * Initializes the package system and loads the package configuration and settings
307 * provided by the packages.
308 *
309 * @param string $packageManagerClassName Define an alternative package manager implementation (usually for the installer)
310 * @return Bootstrap
311 */
312 protected function initializePackageManagement($packageManagerClassName) {
313 /** @var \TYPO3\CMS\Core\Package\PackageManager $packageManager */
314 $packageManager = new $packageManagerClassName();
315 $this->setEarlyInstance('TYPO3\\Flow\\Package\\PackageManager', $packageManager);
316 Utility\ExtensionManagementUtility::setPackageManager($packageManager);
317 $packageManager->injectClassLoader($this->getEarlyInstance('TYPO3\\CMS\\Core\\Core\\ClassLoader'));
318 $packageManager->injectCoreCache($this->getEarlyInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager')->getCache('cache_core'));
319 $packageManager->initialize($this, PATH_site);
320 Utility\GeneralUtility::setSingletonInstance('TYPO3\\CMS\\Core\\Package\\PackageManager', $packageManager);
321 $GLOBALS['TYPO3_LOADED_EXT'] = new \TYPO3\CMS\Core\Compatibility\LoadedExtensionsArray($packageManager);
322 return $this;
323 }
324
325 /**
326 * Activates a package during runtime. This is used in AdditionalConfiguration.php
327 * to enable extensions under conditions.
328 *
329 * @return Bootstrap
330 */
331 protected function initializeRuntimeActivatedPackagesFromConfiguration() {
332 if (isset($GLOBALS['TYPO3_CONF_VARS']['EXT']['runtimeActivatedPackages']) && is_array($GLOBALS['TYPO3_CONF_VARS']['EXT']['runtimeActivatedPackages'])) {
333 /** @var \TYPO3\CMS\Core\Package\PackageManager $packageManager */
334 $packageManager = $this->getEarlyInstance('TYPO3\\Flow\\Package\\PackageManager');
335 foreach ($GLOBALS['TYPO3_CONF_VARS']['EXT']['runtimeActivatedPackages'] as $runtimeAddedPackageKey) {
336 $packageManager->activatePackageDuringRuntime($runtimeAddedPackageKey);
337 }
338 }
339 return $this;
340 }
341
342 /**
343 * Load ext_localconf of extensions
344 *
345 * @param boolean $allowCaching
346 * @return Bootstrap
347 * @internal This is not a public API method, do not use in own extensions
348 */
349 public function loadTypo3LoadedExtAndExtLocalconf($allowCaching = TRUE) {
350 $this->getInstance()
351 ->loadAdditionalConfigurationFromExtensions($allowCaching);
352 return $this;
353 }
354
355 /**
356 * Load TYPO3_LOADED_EXT, recreate class loader registry and load ext_localconf
357 *
358 * @TODO: This method was changed with the package manager patch, do we still need it?
359 * @return Bootstrap
360 * @internal This is not a public API method, do not use in own extensions
361 */
362 public function reloadTypo3LoadedExtAndClassLoaderAndExtLocalconf() {
363 $bootstrap = $this->getInstance();
364 // Commented out for package management patch, method is still used in extensionmanager
365 // $bootstrap->populateTypo3LoadedExtGlobal(FALSE);
366 // \TYPO3\CMS\Core\Core\ClassLoader::loadClassLoaderCache();
367 $bootstrap->loadAdditionalConfigurationFromExtensions(FALSE);
368 return $this;
369 }
370
371 /**
372 * Sets up additional configuration applied in all scopes
373 *
374 * @return Bootstrap
375 * @internal This is not a public API method, do not use in own extensions
376 */
377 public function applyAdditionalConfigurationSettings() {
378 $this->getInstance()
379 ->initializeExceptionHandling()
380 ->setFinalCachingFrameworkCacheConfiguration()
381 ->defineLoggingAndExceptionConstants()
382 ->unsetReservedGlobalVariables();
383 return $this;
384 }
385
386 /**
387 * Throws an exception if no browser could be identified
388 *
389 * @return Bootstrap
390 * @throws \RuntimeException
391 * @internal This is not a public API method, do not use in own extensions
392 */
393 public function checkValidBrowserOrDie() {
394 // Checks for proper browser
395 if (empty($GLOBALS['CLIENT']['BROWSER'])) {
396 throw new \RuntimeException('Browser Error: Your browser version looks incompatible with this TYPO3 version!', 1294587023);
397 }
398 return $this;
399 }
400
401 /**
402 * We need an early instance of the configuration manager.
403 * Since makeInstance relies on the object configuration, we create it here with new instead.
404 *
405 * @return Bootstrap
406 */
407 public function populateLocalConfiguration() {
408 $configurationManager = new \TYPO3\CMS\Core\Configuration\ConfigurationManager();
409 $this->setEarlyInstance('TYPO3\CMS\Core\Configuration\ConfigurationManager', $configurationManager);
410 $configurationManager->exportConfiguration();
411 return $this;
412 }
413
414 /**
415 * Set cache_core to null backend, effectively disabling eg. the autoloader cache
416 *
417 * @return \TYPO3\CMS\Core\Core\Bootstrap
418 * @internal This is not a public API method, do not use in own extensions
419 */
420 public function setCoreCacheToNullBackend() {
421 $GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['cache_core']['backend']
422 = 'TYPO3\\CMS\\Core\\Cache\\Backend\\NullBackend';
423 return $this;
424 }
425
426 /**
427 * Define database constants
428 *
429 * @return \TYPO3\CMS\Core\Core\Bootstrap
430 */
431 protected function defineDatabaseConstants() {
432 define('TYPO3_db', $GLOBALS['TYPO3_CONF_VARS']['DB']['database']);
433 define('TYPO3_db_username', $GLOBALS['TYPO3_CONF_VARS']['DB']['username']);
434 define('TYPO3_db_password', $GLOBALS['TYPO3_CONF_VARS']['DB']['password']);
435 define('TYPO3_db_host', $GLOBALS['TYPO3_CONF_VARS']['DB']['host']);
436 define('TYPO3_extTableDef_script',
437 isset($GLOBALS['TYPO3_CONF_VARS']['DB']['extTablesDefinitionScript'])
438 ? $GLOBALS['TYPO3_CONF_VARS']['DB']['extTablesDefinitionScript']
439 : 'extTables.php');
440 return $this;
441 }
442
443 /**
444 * Define user agent constant
445 *
446 * @return \TYPO3\CMS\Core\Core\Bootstrap
447 */
448 protected function defineUserAgentConstant() {
449 define('TYPO3_user_agent', 'User-Agent: ' . $GLOBALS['TYPO3_CONF_VARS']['HTTP']['userAgent']);
450 return $this;
451 }
452
453 /**
454 * Register default ExtDirect components
455 *
456 * @return Bootstrap
457 */
458 protected function registerExtDirectComponents() {
459 if (TYPO3_MODE === 'BE') {
460 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.Components.PageTree.DataProvider', 'TYPO3\\CMS\\Backend\\Tree\\Pagetree\\ExtdirectTreeDataProvider', 'web', 'user,group');
461 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.Components.PageTree.Commands', 'TYPO3\\CMS\\Backend\\Tree\\Pagetree\\ExtdirectTreeCommands', 'web', 'user,group');
462 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.Components.PageTree.ContextMenuDataProvider', 'TYPO3\\CMS\\Backend\\ContextMenu\\Pagetree\\Extdirect\\ContextMenuConfiguration', 'web', 'user,group');
463 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.LiveSearchActions.ExtDirect', 'TYPO3\\CMS\\Backend\\Search\\LiveSearch\\ExtDirect\\LiveSearchDataProvider', 'web_list', 'user,group');
464 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.BackendUserSettings.ExtDirect', 'TYPO3\\CMS\\Backend\\User\\ExtDirect\\BackendUserSettingsDataProvider');
465 if (Utility\ExtensionManagementUtility::isLoaded('context_help')) {
466 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.CSH.ExtDirect', 'TYPO3\\CMS\\ContextHelp\\ExtDirect\\ContextHelpDataProvider');
467 }
468 Utility\ExtensionManagementUtility::registerExtDirectComponent('TYPO3.ExtDirectStateProvider.ExtDirect', 'TYPO3\\CMS\\Backend\\InterfaceState\\ExtDirect\\DataProvider');
469 Utility\ExtensionManagementUtility::registerExtDirectComponent(
470 'TYPO3.Components.DragAndDrop.CommandController',
471 Utility\ExtensionManagementUtility::extPath('backend') . 'Classes/View/PageLayout/Extdirect/ExtdirectPageCommands.php:TYPO3\\CMS\\Backend\\View\\PageLayout\\ExtDirect\\ExtdirectPageCommands', 'web', 'user,group'
472 );
473 }
474 return $this;
475 }
476
477 /**
478 * Initialize caching framework
479 *
480 * @return Bootstrap
481 */
482 protected function initializeCachingFramework() {
483 // @todo Please deuglify
484 \TYPO3\CMS\Core\Cache\Cache::initializeCachingFramework();
485 $this->setEarlyInstance('TYPO3\CMS\Core\Cache\CacheManager', $GLOBALS['typo3CacheManager']);
486 return $this;
487 }
488
489 /**
490 * Parse old curl options and set new http ones instead
491 *
492 * @TODO: This code segment must still be finished
493 * @return Bootstrap
494 */
495 protected function transferDeprecatedCurlSettings() {
496 if (!empty($GLOBALS['TYPO3_CONF_VARS']['SYS']['curlProxyServer'])) {
497 $proxyParts = Utility\GeneralUtility::revExplode(':', $GLOBALS['TYPO3_CONF_VARS']['SYS']['curlProxyServer'], 2);
498 $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy_host'] = $proxyParts[0];
499 $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy_port'] = $proxyParts[1];
500 }
501 if (!empty($GLOBALS['TYPO3_CONF_VARS']['SYS']['curlProxyUserPass'])) {
502 $userPassParts = explode(':', $GLOBALS['TYPO3_CONF_VARS']['SYS']['curlProxyUserPass'], 2);
503 $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy_user'] = $userPassParts[0];
504 $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy_password'] = $userPassParts[1];
505 }
506 return $this;
507 }
508
509 /**
510 * Set cacheHash options
511 *
512 * @return Bootstrap
513 */
514 protected function setCacheHashOptions() {
515 $GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash'] = array(
516 'cachedParametersWhiteList' => Utility\GeneralUtility::trimExplode(',', $GLOBALS['TYPO3_CONF_VARS']['FE']['cHashOnlyForParameters'], TRUE),
517 'excludedParameters' => Utility\GeneralUtility::trimExplode(',', $GLOBALS['TYPO3_CONF_VARS']['FE']['cHashExcludedParameters'], TRUE),
518 'requireCacheHashPresenceParameters' => Utility\GeneralUtility::trimExplode(',', $GLOBALS['TYPO3_CONF_VARS']['FE']['cHashRequiredParameters'], TRUE)
519 );
520 if (trim($GLOBALS['TYPO3_CONF_VARS']['FE']['cHashExcludedParametersIfEmpty']) === '*') {
521 $GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash']['excludeAllEmptyParameters'] = TRUE;
522 } else {
523 $GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash']['excludedParametersIfEmpty'] = Utility\GeneralUtility::trimExplode(',', $GLOBALS['TYPO3_CONF_VARS']['FE']['cHashExcludedParametersIfEmpty'], TRUE);
524 }
525 return $this;
526 }
527
528 /**
529 * Set default timezone
530 *
531 * @return Bootstrap
532 */
533 protected function setDefaultTimezone() {
534 $timeZone = $GLOBALS['TYPO3_CONF_VARS']['SYS']['phpTimeZone'];
535 if (empty($timeZone)) {
536 // Time zone from the server environment (TZ env or OS query)
537 $defaultTimeZone = @date_default_timezone_get();
538 if ($defaultTimeZone !== '') {
539 $timeZone = $defaultTimeZone;
540 } else {
541 $timeZone = 'UTC';
542 }
543 }
544 // Set default to avoid E_WARNINGs with PHP > 5.3
545 date_default_timezone_set($timeZone);
546 return $this;
547 }
548
549 /**
550 * Initialize the locales handled by TYPO3
551 *
552 * @return Bootstrap
553 */
554 protected function initializeL10nLocales() {
555 \TYPO3\CMS\Core\Localization\Locales::initialize();
556 return $this;
557 }
558
559 /**
560 * Convert type of "pageNotFound_handling" setting in case it was written as a
561 * string (e.g. if edited in Install Tool)
562 *
563 * @TODO : Remove, if the Install Tool handles such data types correctly
564 * @return Bootstrap
565 */
566 protected function convertPageNotFoundHandlingToBoolean() {
567 if (!strcasecmp($GLOBALS['TYPO3_CONF_VARS']['FE']['pageNotFound_handling'], 'TRUE')) {
568 $GLOBALS['TYPO3_CONF_VARS']['FE']['pageNotFound_handling'] = TRUE;
569 }
570 return $this;
571 }
572
573 /**
574 * Register xdebug(), debug(), debugBegin() and debugEnd() as global functions
575 *
576 * Note: Yes, this is possible in php! xdebug() is then a global function, even
577 * if registerGlobalDebugFunctions() is encapsulated in class scope.
578 *
579 * @return Bootstrap
580 */
581 protected function registerGlobalDebugFunctions() {
582 require_once('GlobalDebugFunctions.php');
583 return $this;
584 }
585
586 /**
587 * Mail sending via Swift Mailer
588 *
589 * @return \TYPO3\CMS\Core\Core\Bootstrap
590 * @deprecated since 6.1, will be removed two versions later - will be removed together with \TYPO3\CMS\Core\Utility\MailUtility::mail()
591 */
592 protected function registerSwiftMailer() {
593 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/utility/class.t3lib_utility_mail.php']['substituteMailDelivery'][] =
594 'TYPO3\\CMS\\Core\\Mail\\SwiftMailerAdapter';
595 return $this;
596 }
597
598 /**
599 * Configure and set up exception and error handling
600 *
601 * @return Bootstrap
602 */
603 protected function configureExceptionHandling() {
604 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionHandler'] = $GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'];
605 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionalErrors'] = $GLOBALS['TYPO3_CONF_VARS']['SYS']['exceptionalErrors'];
606 // Turn error logging on/off.
607 if (($displayErrors = intval($GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'])) != '-1') {
608 // Special value "2" enables this feature only if $GLOBALS['TYPO3_CONF_VARS'][SYS][devIPmask] matches
609 if ($displayErrors == 2) {
610 if (Utility\GeneralUtility::cmpIP(Utility\GeneralUtility::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
611 $displayErrors = 1;
612 } else {
613 $displayErrors = 0;
614 }
615 }
616 if ($displayErrors == 0) {
617 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionalErrors'] = 0;
618 }
619 if ($displayErrors == 1) {
620 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionHandler'] = $GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'];
621 define('TYPO3_ERRORHANDLER_MODE', 'debug');
622 }
623 @ini_set('display_errors', $displayErrors);
624 } elseif (Utility\GeneralUtility::cmpIP(Utility\GeneralUtility::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
625 // With displayErrors = -1 (default), turn on debugging if devIPmask matches:
626 $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionHandler'] = $GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'];
627 }
628 return $this;
629 }
630
631 /**
632 * Set PHP memory limit depending on value of
633 * $GLOBALS['TYPO3_CONF_VARS']['SYS']['setMemoryLimit']
634 *
635 * @return Bootstrap
636 */
637 protected function setMemoryLimit() {
638 if (intval($GLOBALS['TYPO3_CONF_VARS']['SYS']['setMemoryLimit']) > 16) {
639 @ini_set('memory_limit', (intval($GLOBALS['TYPO3_CONF_VARS']['SYS']['setMemoryLimit']) . 'm'));
640 }
641 return $this;
642 }
643
644 /**
645 * Define TYPO3_REQUESTTYPE* constants
646 * so devs exactly know what type of request it is
647 *
648 * @return Bootstrap
649 */
650 protected function defineTypo3RequestTypes() {
651 define('TYPO3_REQUESTTYPE_FE', 1);
652 define('TYPO3_REQUESTTYPE_BE', 2);
653 define('TYPO3_REQUESTTYPE_CLI', 4);
654 define('TYPO3_REQUESTTYPE_AJAX', 8);
655 define('TYPO3_REQUESTTYPE_INSTALL', 16);
656 define('TYPO3_REQUESTTYPE', (TYPO3_MODE == 'FE' ? TYPO3_REQUESTTYPE_FE : 0) | (TYPO3_MODE == 'BE' ? TYPO3_REQUESTTYPE_BE : 0) | (defined('TYPO3_cliMode') && TYPO3_cliMode ? TYPO3_REQUESTTYPE_CLI : 0) | (defined('TYPO3_enterInstallScript') && TYPO3_enterInstallScript ? TYPO3_REQUESTTYPE_INSTALL : 0) | ($GLOBALS['TYPO3_AJAX'] ? TYPO3_REQUESTTYPE_AJAX : 0));
657 return $this;
658 }
659
660 /**
661 * Load extension configuration files (ext_localconf.php)
662 *
663 * The ext_localconf.php files in extensions are meant to make changes
664 * to the global $TYPO3_CONF_VARS configuration array.
665 *
666 * @param boolean $allowCaching
667 * @return Bootstrap
668 */
669 protected function loadAdditionalConfigurationFromExtensions($allowCaching = TRUE) {
670 Utility\ExtensionManagementUtility::loadExtLocalconf($allowCaching);
671 return $this;
672 }
673
674 /**
675 * Initialize exception handling
676 *
677 * @return Bootstrap
678 */
679 protected function initializeExceptionHandling() {
680 if (!empty($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionHandler'])) {
681 if (!empty($GLOBALS['TYPO3_CONF_VARS']['SYS']['errorHandler'])) {
682 // Register an error handler for the given errorHandlerErrors
683 $errorHandler = Utility\GeneralUtility::makeInstance($GLOBALS['TYPO3_CONF_VARS']['SYS']['errorHandler'], $GLOBALS['TYPO3_CONF_VARS']['SYS']['errorHandlerErrors']);
684 // Set errors which will be converted in an exception
685 $errorHandler->setExceptionalErrors($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionalErrors']);
686 }
687 // Instantiate the exception handler once to make sure object is registered
688 // @TODO: Figure out if this is really needed
689 Utility\GeneralUtility::makeInstance($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['errors']['exceptionHandler']);
690 }
691 return $this;
692 }
693
694 /**
695 * Extensions may register new caches, so we set the
696 * global cache array to the manager again at this point
697 *
698 * @return Bootstrap
699 */
700 protected function setFinalCachingFrameworkCacheConfiguration() {
701 $GLOBALS['typo3CacheManager']->setCacheConfigurations($GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']);
702 return $this;
703 }
704
705 /**
706 * Define logging and exception constants
707 *
708 * @return Bootstrap
709 */
710 protected function defineLoggingAndExceptionConstants() {
711 define('TYPO3_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_DLOG']);
712 define('TYPO3_ERROR_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_errorDLOG']);
713 define('TYPO3_EXCEPTION_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_exceptionDLOG']);
714 return $this;
715 }
716
717 /**
718 * Unsetting reserved global variables:
719 * Those are set in "ext:core/ext_tables.php" file:
720 *
721 * @return Bootstrap
722 */
723 protected function unsetReservedGlobalVariables() {
724 unset($GLOBALS['PAGES_TYPES']);
725 unset($GLOBALS['TCA']);
726 unset($GLOBALS['TBE_MODULES']);
727 unset($GLOBALS['TBE_STYLES']);
728 unset($GLOBALS['FILEICONS']);
729 // Those set in init.php:
730 unset($GLOBALS['WEBMOUNTS']);
731 unset($GLOBALS['FILEMOUNTS']);
732 unset($GLOBALS['BE_USER']);
733 // Those set otherwise:
734 unset($GLOBALS['TBE_MODULES_EXT']);
735 unset($GLOBALS['TCA_DESCR']);
736 unset($GLOBALS['LOCAL_LANG']);
737 unset($GLOBALS['TYPO3_AJAX']);
738 return $this;
739 }
740
741 /**
742 * Initialize database connection in $GLOBALS and connect if requested
743 *
744 * @return \TYPO3\CMS\Core\Core\Bootstrap
745 * @internal This is not a public API method, do not use in own extensions
746 */
747 public function initializeTypo3DbGlobal() {
748 /** @var $databaseConnection \TYPO3\CMS\Core\Database\DatabaseConnection */
749 $databaseConnection = Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Database\\DatabaseConnection');
750 $databaseConnection->setDatabaseName(TYPO3_db);
751 $databaseConnection->setDatabaseUsername(TYPO3_db_username);
752 $databaseConnection->setDatabasePassword(TYPO3_db_password);
753
754 $databaseHost = TYPO3_db_host;
755 if (isset($GLOBALS['TYPO3_CONF_VARS']['DB']['port'])) {
756 $databaseConnection->setDatabasePort($GLOBALS['TYPO3_CONF_VARS']['DB']['port']);
757 } elseif (strpos($databaseHost, ':') > 0) {
758 // @TODO: Find a way to handle this case in the install tool and drop this
759 list($databaseHost, $databasePort) = explode(':', $databaseHost);
760 $databaseConnection->setDatabasePort($databasePort);
761 }
762 if (isset($GLOBALS['TYPO3_CONF_VARS']['DB']['socket'])) {
763 $databaseConnection->setDatabaseSocket($GLOBALS['TYPO3_CONF_VARS']['DB']['socket']);
764 }
765 $databaseConnection->setDatabaseHost($databaseHost);
766
767 $databaseConnection->debugOutput = $GLOBALS['TYPO3_CONF_VARS']['SYS']['sqlDebug'];
768
769 if (
770 isset($GLOBALS['TYPO3_CONF_VARS']['SYS']['no_pconnect'])
771 && !$GLOBALS['TYPO3_CONF_VARS']['SYS']['no_pconnect']
772 ) {
773 $databaseConnection->setPersistentDatabaseConnection(TRUE);
774 }
775
776 $isDatabaseHostLocalHost = $databaseHost === 'localhost' || $databaseHost === '127.0.0.1' || $databaseHost === '::1';
777 if (
778 isset($GLOBALS['TYPO3_CONF_VARS']['SYS']['dbClientCompress'])
779 && $GLOBALS['TYPO3_CONF_VARS']['SYS']['dbClientCompress']
780 && !$isDatabaseHostLocalHost
781 ) {
782 $databaseConnection->setConnectionCompression(TRUE);
783 }
784
785 if (!empty($GLOBALS['TYPO3_CONF_VARS']['SYS']['setDBinit'])) {
786 $commandsAfterConnect = \TYPO3\CMS\Core\Utility\GeneralUtility::trimExplode(
787 LF,
788 str_replace('\' . LF . \'', LF, $GLOBALS['TYPO3_CONF_VARS']['SYS']['setDBinit']),
789 TRUE
790 );
791 $databaseConnection->setInitializeCommandsAfterConnect($commandsAfterConnect);
792 }
793
794 $GLOBALS['TYPO3_DB'] = $databaseConnection;
795
796 return $this;
797 }
798
799 /**
800 * Check adminOnly configuration variable and redirects
801 * to an URL in file typo3conf/LOCK_BACKEND or exit the script
802 *
803 * @throws \RuntimeException
804 * @return Bootstrap
805 * @internal This is not a public API method, do not use in own extensions
806 */
807 public function checkLockedBackendAndRedirectOrDie() {
808 if ($GLOBALS['TYPO3_CONF_VARS']['BE']['adminOnly'] < 0) {
809 throw new \RuntimeException('TYPO3 Backend locked: Backend and Install Tool are locked for maintenance. [BE][adminOnly] is set to "' . intval($GLOBALS['TYPO3_CONF_VARS']['BE']['adminOnly']) . '".', 1294586847);
810 }
811 if (@is_file((PATH_typo3conf . 'LOCK_BACKEND'))) {
812 if (TYPO3_PROCEED_IF_NO_USER === 2) {
813
814 } else {
815 $fileContent = Utility\GeneralUtility::getUrl(PATH_typo3conf . 'LOCK_BACKEND');
816 if ($fileContent) {
817 header('Location: ' . $fileContent);
818 } else {
819 throw new \RuntimeException('TYPO3 Backend locked: Browser backend is locked for maintenance. Remove lock by removing the file "typo3conf/LOCK_BACKEND" or use CLI-scripts.', 1294586848);
820 }
821 die;
822 }
823 }
824 return $this;
825 }
826
827 /**
828 * Compare client IP with IPmaskList and exit the script run
829 * if the client is not allowed to access the backend
830 *
831 * @return Bootstrap
832 * @internal This is not a public API method, do not use in own extensions
833 */
834 public function checkBackendIpOrDie() {
835 if (trim($GLOBALS['TYPO3_CONF_VARS']['BE']['IPmaskList'])) {
836 if (!Utility\GeneralUtility::cmpIP(Utility\GeneralUtility::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['BE']['IPmaskList'])) {
837 // Send Not Found header - if the webserver can make use of it
838 header('Status: 404 Not Found');
839 // Just point us away from here...
840 header('Location: http://');
841 // ... and exit good!
842 die;
843 }
844 }
845 return $this;
846 }
847
848 /**
849 * Check lockSSL configuration variable and redirect
850 * to https version of the backend if needed
851 *
852 * @return Bootstrap
853 * @internal This is not a public API method, do not use in own extensions
854 */
855 public function checkSslBackendAndRedirectIfNeeded() {
856 if (intval($GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSL'])) {
857 if (intval($GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSLPort'])) {
858 $sslPortSuffix = ':' . intval($GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSLPort']);
859 } else {
860 $sslPortSuffix = '';
861 }
862 if ($GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSL'] == 3) {
863 $requestStr = substr(Utility\GeneralUtility::getIndpEnv('TYPO3_REQUEST_SCRIPT'), strlen(Utility\GeneralUtility::getIndpEnv('TYPO3_SITE_URL') . TYPO3_mainDir));
864 if ($requestStr === 'index.php' && !Utility\GeneralUtility::getIndpEnv('TYPO3_SSL')) {
865 list(, $url) = explode('://', Utility\GeneralUtility::getIndpEnv('TYPO3_REQUEST_URL'), 2);
866 list($server, $address) = explode('/', $url, 2);
867 header('Location: https://' . $server . $sslPortSuffix . '/' . $address);
868 die;
869 }
870 } elseif (!Utility\GeneralUtility::getIndpEnv('TYPO3_SSL')) {
871 if (intval($GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSL']) === 2) {
872 list(, $url) = explode('://', Utility\GeneralUtility::getIndpEnv('TYPO3_SITE_URL') . TYPO3_mainDir, 2);
873 list($server, $address) = explode('/', $url, 2);
874 header('Location: https://' . $server . $sslPortSuffix . '/' . $address);
875 } else {
876 // Send Not Found header - if the webserver can make use of it...
877 header('Status: 404 Not Found');
878 // Just point us away from here...
879 header('Location: http://');
880 }
881 // ... and exit good!
882 die;
883 }
884 }
885 return $this;
886 }
887
888 /**
889 * Load TCA for frontend
890 *
891 * This method is *only* executed in frontend scope. The idea is to execute the
892 * whole TCA and ext_tables (which manipulate TCA) on first frontend access,
893 * and then cache the full TCA on disk to be used for the next run again.
894 *
895 * This way, ext_tables.php ist not executed every time, but $GLOBALS['TCA']
896 * is still always there.
897 *
898 * @return Bootstrap
899 * @internal This is not a public API method, do not use in own extensions
900 */
901 public function loadCachedTca() {
902 $cacheIdentifier = 'tca_fe_' . sha1((TYPO3_version . PATH_site . 'tca_fe'));
903 /** @var $codeCache \TYPO3\CMS\Core\Cache\Frontend\PhpFrontend */
904 $codeCache = $GLOBALS['typo3CacheManager']->getCache('cache_core');
905 if ($codeCache->has($cacheIdentifier)) {
906 // substr is necessary, because the php frontend wraps php code around the cache value
907 $GLOBALS['TCA'] = unserialize(substr($codeCache->get($cacheIdentifier), 6, -2));
908 } else {
909 $this->loadExtensionTables(TRUE);
910 $codeCache->set($cacheIdentifier, serialize($GLOBALS['TCA']));
911 }
912 return $this;
913 }
914
915 /**
916 * Load ext_tables and friends.
917 *
918 * This will mainly set up $TCA and several other global arrays
919 * through API's like extMgm.
920 * Executes ext_tables.php files of loaded extensions or the
921 * according cache file if exists.
922 *
923 * @param boolean $allowCaching True, if reading compiled ext_tables file from cache is allowed
924 * @return Bootstrap
925 * @internal This is not a public API method, do not use in own extensions
926 */
927 public function loadExtensionTables($allowCaching = TRUE) {
928 Utility\ExtensionManagementUtility::loadBaseTca($allowCaching);
929 Utility\ExtensionManagementUtility::loadExtTables($allowCaching);
930 $this->executeExtTablesAdditionalFile();
931 $this->runExtTablesPostProcessingHooks();
932 return $this;
933 }
934
935 /**
936 * Execute TYPO3_extTableDef_script if defined and exists
937 *
938 * Note: For backwards compatibility some global variables are
939 * explicitly set as global to be used without $GLOBALS[] in
940 * the extension table script. It is discouraged to access variables like
941 * $TBE_MODULES directly, but we can not prohibit
942 * this without heavily breaking backwards compatibility.
943 *
944 * @TODO : We could write a scheduler / reports module or an update checker
945 * @TODO : It should be defined, which global arrays are ok to be manipulated
946 *
947 * @return void
948 */
949 protected function executeExtTablesAdditionalFile() {
950 // It is discouraged to use those global variables directly, but we
951 // can not prohibit this without breaking backwards compatibility
952 global $T3_SERVICES, $T3_VAR, $TYPO3_CONF_VARS;
953 global $TBE_MODULES, $TBE_MODULES_EXT, $TCA;
954 global $PAGES_TYPES, $TBE_STYLES, $FILEICONS;
955 global $_EXTKEY;
956 // Load additional ext tables script if the file exists
957 $extTablesFile = PATH_typo3conf . TYPO3_extTableDef_script;
958 if (file_exists($extTablesFile) && is_file($extTablesFile)) {
959 include $extTablesFile;
960 }
961
962 // Apply TCA onto tables to be categorized
963 \TYPO3\CMS\Core\Category\CategoryRegistry::getInstance()->applyTca();
964 }
965
966 /**
967 * Check for registered ext tables hooks and run them
968 *
969 * @throws \UnexpectedValueException
970 * @return void
971 */
972 protected function runExtTablesPostProcessingHooks() {
973 if (is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['GLOBAL']['extTablesInclusion-PostProcessing'])) {
974 foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['GLOBAL']['extTablesInclusion-PostProcessing'] as $classReference) {
975 /** @var $hookObject \TYPO3\CMS\Core\Database\TableConfigurationPostProcessingHookInterface */
976 $hookObject = Utility\GeneralUtility::getUserObj($classReference);
977 if (!$hookObject instanceof \TYPO3\CMS\Core\Database\TableConfigurationPostProcessingHookInterface) {
978 throw new \UnexpectedValueException('$hookObject must implement interface TYPO3\\CMS\\Core\\Database\\TableConfigurationPostProcessingHookInterface', 1320585902);
979 }
980 $hookObject->processData();
981 }
982 }
983 }
984
985 /**
986 * Initialize sprite manager
987 *
988 * @return Bootstrap
989 * @internal This is not a public API method, do not use in own extensions
990 */
991 public function initializeSpriteManager() {
992 \TYPO3\CMS\Backend\Sprite\SpriteManager::initialize();
993 return $this;
994 }
995
996 /**
997 * Initialize backend user object in globals
998 *
999 * @return Bootstrap
1000 * @internal This is not a public API method, do not use in own extensions
1001 */
1002 public function initializeBackendUser() {
1003 /** @var $backendUser \TYPO3\CMS\Core\Authentication\BackendUserAuthentication */
1004 $backendUser = Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Authentication\\BackendUserAuthentication');
1005 $backendUser->warningEmail = $GLOBALS['TYPO3_CONF_VARS']['BE']['warning_email_addr'];
1006 $backendUser->lockIP = $GLOBALS['TYPO3_CONF_VARS']['BE']['lockIP'];
1007 $backendUser->auth_timeout_field = intval($GLOBALS['TYPO3_CONF_VARS']['BE']['sessionTimeout']);
1008 $backendUser->OS = TYPO3_OS;
1009 if (TYPO3_REQUESTTYPE & TYPO3_REQUESTTYPE_CLI) {
1010 $backendUser->dontSetCookie = TRUE;
1011 }
1012 // The global must be available very early, because methods below
1013 // might trigger code which relies on it. See: #45625
1014 $GLOBALS['BE_USER'] = $backendUser;
1015 $backendUser->start();
1016 return $this;
1017 }
1018
1019 /**
1020 * Initializes and ensures authenticated access
1021 *
1022 * @internal This is not a public API method, do not use in own extensions
1023 * @return \TYPO3\CMS\Core\Core\Bootstrap
1024 */
1025 public function initializeBackendAuthentication() {
1026 $GLOBALS['BE_USER']->checkCLIuser();
1027 $GLOBALS['BE_USER']->backendCheckLogin();
1028 return $this;
1029 }
1030
1031 /**
1032 * Initialize backend user mount points
1033 *
1034 * @return Bootstrap
1035 * @internal This is not a public API method, do not use in own extensions
1036 */
1037 public function initializeBackendUserMounts() {
1038 // Includes deleted mount pages as well! @TODO: Figure out why ...
1039 $GLOBALS['WEBMOUNTS'] = $GLOBALS['BE_USER']->returnWebmounts();
1040 $GLOBALS['BE_USER']->getFileStorages();
1041 $GLOBALS['FILEMOUNTS'] = $GLOBALS['BE_USER']->groupData['filemounts'];
1042 return $this;
1043 }
1044
1045 /**
1046 * Initialize language object
1047 *
1048 * @return Bootstrap
1049 * @internal This is not a public API method, do not use in own extensions
1050 */
1051 public function initializeLanguageObject() {
1052 /** @var $GLOBALS['LANG'] \TYPO3\CMS\Lang\LanguageService */
1053 $GLOBALS['LANG'] = Utility\GeneralUtility::makeInstance('TYPO3\CMS\Lang\LanguageService');
1054 $GLOBALS['LANG']->init($GLOBALS['BE_USER']->uc['lang']);
1055 return $this;
1056 }
1057
1058 /**
1059 * Throw away all output that may have happened during bootstrapping by weird extensions
1060 *
1061 * @return Bootstrap
1062 * @internal This is not a public API method, do not use in own extensions
1063 */
1064 public function endOutputBufferingAndCleanPreviousOutput() {
1065 ob_clean();
1066 return $this;
1067 }
1068
1069 /**
1070 * Initialize output compression if configured
1071 *
1072 * @return Bootstrap
1073 * @internal This is not a public API method, do not use in own extensions
1074 */
1075 public function initializeOutputCompression() {
1076 if (extension_loaded('zlib') && $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel']) {
1077 if (Utility\MathUtility::canBeInterpretedAsInteger($GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'])) {
1078 @ini_set('zlib.output_compression_level', $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel']);
1079 }
1080 ob_start('ob_gzhandler');
1081 }
1082 return $this;
1083 }
1084
1085 /**
1086 * Initialize module menu object
1087 *
1088 * @return Bootstrap
1089 * @internal This is not a public API method, do not use in own extensions
1090 */
1091 public function initializeModuleMenuObject() {
1092 /** @var $moduleMenuUtility \TYPO3\CMS\Backend\Module\ModuleController */
1093 $moduleMenuUtility = Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Module\\ModuleController');
1094 $moduleMenuUtility->createModuleMenu();
1095 return $this;
1096 }
1097
1098 /**
1099 * Things that should be performed to shut down the framework.
1100 * This method is called in all important scripts for a clean
1101 * shut down of the system.
1102 *
1103 * @return Bootstrap
1104 * @internal This is not a public API method, do not use in own extensions
1105 */
1106 public function shutdown() {
1107 return $this;
1108 }
1109
1110 /**
1111 * Provides an instance of "template" for backend-modules to
1112 * work with.
1113 *
1114 * @return Bootstrap
1115 * @internal This is not a public API method, do not use in own extensions
1116 */
1117 public function initializeBackendTemplate() {
1118 $GLOBALS['TBE_TEMPLATE'] = Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Template\\DocumentTemplate');
1119 return $this;
1120 }
1121 }