2 /***************************************************************
5 * (c) 1999-2009 Kasper Skaarhoj (kasperYYYY@typo3.com)
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
29 * Class for the built TypoScript based Front End
31 * This class has a lot of functions and internal variable which are use from index_ts.php.
32 * The class is instantiated as $GLOBALS['TSFE'] in index_ts.php.
33 * The use of this class should be inspired by the order of function calls as found in index_ts.php.
36 * Revised for TYPO3 3.6 June/2003 by Kasper Skaarhoj
39 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
43 * [CLASS/FUNCTION INDEX of SCRIPT]
48 * 382: function tslib_fe($TYPO3_CONF_VARS, $id, $type, $no_cache='', $cHash='', $jumpurl='',$MP='',$RDCT='')
49 * 415: function connectToMySQL()
50 * 425: function connectToDB()
51 * 470: function sendRedirect()
53 * SECTION: Initializing, resolving page id
54 * 508: function initFEuser()
55 * 558: function initUserGroups()
56 * 593: function isUserOrGroupSet()
57 * 618: function checkAlternativeIdMethods()
58 * 670: function clear_preview()
59 * 683: function determineId()
60 * 817: function fetch_the_id()
61 * 911: function getPageAndRootline()
62 * 994: function getPageShortcut($SC,$mode,$thisUid,$itera=20,$pageLog=array())
63 * 1044: function checkRootlineForIncludeSection()
64 * 1081: function checkEnableFields($row,$bypassGroupCheck=FALSE)
65 * 1097: function checkPageGroupAccess($row, $groupList=NULL)
66 * 1116: function checkPagerecordForIncludeSection($row)
67 * 1125: function checkIfLoginAllowedInBranch()
68 * 1150: function getPageAccessFailureReasons()
69 * 1182: function setIDfromArgV()
70 * 1198: function getPageAndRootlineWithDomain($domainStartPage)
71 * 1225: function setSysPageWhereClause()
72 * 1237: function findDomainRecord($recursive=0)
73 * 1257: function pageNotFoundAndExit($reason='', $header='')
74 * 1272: function pageNotFoundHandler($code, $header='', $reason='')
75 * 1316: function checkAndSetAlias()
76 * 1335: function idPartsAnalyze($str)
77 * 1360: function mergingWithGetVars($GET_VARS)
78 * 1390: function ADMCMD_preview()
79 * 1433: function ADMCMD_preview_postInit($previewConfig)
81 * SECTION: Template and caching related functions.
82 * 1465: function makeCacheHash()
83 * 1489: function reqCHash()
84 * 1511: function cHashParams($addQueryParams)
85 * 1520: function initTemplate()
86 * 1532: function getFromCache()
87 * 1578: function getFromCache_queryRow()
88 * 1608: function headerNoCache()
89 * 1637: function getHash()
90 * 1657: function getConfigArray()
92 * SECTION: Further initialization and data processing
93 * 1818: function getCompressedTCarray()
94 * 1872: function includeTCA($TCAloaded=1)
95 * 1899: function settingLanguage()
96 * 1992: function settingLocale()
97 * 2017: function checkDataSubmission()
98 * 2050: function fe_tce()
99 * 2064: function locDataCheck($locationData)
100 * 2080: function sendFormmail()
101 * 2131: function extractRecipientCopy($bodytext)
102 * 2145: function setExternalJumpUrl()
103 * 2156: function checkJumpUrlReferer()
104 * 2171: function jumpUrl()
105 * 2215: function setUrlIdToken()
107 * SECTION: Page generation; cache handling
108 * 2258: function isGeneratePage()
109 * 2268: function tempPageCacheContent()
110 * 2325: function realPageCacheContent()
111 * 2355: function setPageCacheContent($content,$data,$tstamp)
112 * 2382: function clearPageCacheContent()
113 * 2392: function clearPageCacheContent_pidList($pidList)
114 * 2426: function setSysLastChanged()
116 * SECTION: Page generation; rendering and inclusion
117 * 2462: function generatePage_preProcessing()
118 * 2484: function generatePage_whichScript()
119 * 2496: function generatePage_postProcessing()
120 * 2588: function INTincScript()
121 * 2648: function INTincScript_loadJSCode()
122 * 2689: function isINTincScript()
123 * 2698: function doXHTML_cleaning()
124 * 2707: function doLocalAnchorFix()
126 * SECTION: Finished off; outputting, storing session data, statistics...
127 * 2738: function isOutputting()
128 * 2761: function processOutput()
129 * 2834: function sendCacheHeaders()
130 * 2902: function isStaticCacheble()
131 * 2915: function contentStrReplace()
132 * 2941: function isEXTincScript()
133 * 2950: function storeSessionData()
134 * 2960: function setParseTime()
135 * 2972: function statistics()
136 * 3066: function previewInfo()
137 * 3101: function hook_eofe()
138 * 3117: function beLoginLinkIPList()
139 * 3138: function addTempContentHttpHeaders()
141 * SECTION: Various internal API functions
142 * 3184: function makeSimulFileName($inTitle,$page,$type,$addParams='',$no_cache='')
143 * 3231: function simulateStaticDocuments_pEnc_onlyP_proc($linkVars)
144 * 3260: function getSimulFileName()
145 * 3271: function setSimulReplacementChar()
146 * 3291: function fileNameASCIIPrefix($inTitle,$titleChars,$mergeChar='.')
147 * 3314: function encryptEmail($string,$back=0)
148 * 3340: function codeString($string, $decode=FALSE)
149 * 3366: function roundTripCryptString($string)
150 * 3386: function checkFileInclude($incFile)
151 * 3401: function newCObj()
152 * 3414: function setAbsRefPrefix()
153 * 3428: function baseUrlWrap($url)
154 * 3447: function printError($label,$header='Error!')
155 * 3458: function updateMD5paramsRecord($hash)
156 * 3469: function tidyHTML($content)
157 * 3495: function prefixLocalAnchorsWithScript()
158 * 3505: function workspacePreviewInit()
159 * 3521: function doWorkspacePreview()
160 * 3531: function whichWorkspace($returnTitle = FALSE)
162 * SECTION: Various external API functions - for use in plugins etc.
163 * 3589: function getStorageSiterootPids()
164 * 3604: function getPagesTSconfig()
165 * 3637: function setJS($key,$content='')
166 * 3677: function setCSS($key,$content)
167 * 3692: function make_seed()
168 * 3705: function uniqueHash($str='')
169 * 3714: function set_no_cache()
170 * 3724: function set_cache_timeout_default($seconds)
171 * 3740: function plainMailEncoded($email,$subject,$message,$headers='')
173 * SECTION: Localization and character set conversion
174 * 3784: function sL($input)
175 * 3813: function readLLfile($fileRef)
176 * 3824: function getLLL($index,$LOCAL_LANG)
177 * 3838: function initLLvars()
178 * 3872: function csConv($str,$from='')
179 * 3890: function convOutputCharset($content,$label='')
180 * 3903: function convPOSTCharset()
182 * TOTAL FUNCTIONS: 116
183 * (This index is automatically created/updated by the extension "extdeveval")
187 require_once (PATH_t3lib
.'class.t3lib_lock.php');
209 * Main frontend class, instantiated in the index_ts.php script as the global object TSFE
211 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
218 var $id=''; // The page id (int)
219 var $type=''; // RO The type (int)
220 var $idParts=array(); // Loaded with the id, exploded by ','
221 var $cHash=''; // The submitted cHash
222 var $no_cache=''; // Page will not be cached. Write only true. Never clear value (some other code might have reasons to set it true)
223 var $rootLine=''; // The rootLine (all the way to tree root, not only the current site!) (array)
224 var $page=''; // The pagerecord (array)
225 var $contentPid=0; // This will normally point to the same value as id, but can be changed to point to another page from which content will then be displayed instead.
226 protected $originalShortcutPage = null; // gets set when we are processing a page of type shortcut in the early stages opf init.php when we do not know about languages yet, used later in init.php to determine the correct shortcut in case a translation changes the shortcut target (array)
229 * sys_page-object, pagefunctions
231 * @var t3lib_pageSelect
235 var $pageNotFound=0; // Is set to 1 if a pageNotFound handler could have been called.
236 var $domainStartPage=0; // Domain start page
237 var $pageAccessFailureHistory=array(); // Array containing a history of why a requested page was not accessible.
240 var $page_cache_reg1=0; // This can be set from applications as a way to tag cached versions of a page and later perform some external cache management, like clearing only a part of the cache of a page...
241 var $siteScript=''; // Contains the value of the current script path that activated the frontend. Typically "index.php" but by rewrite rules it could be something else! Used for Speaking Urls / Simulate Static Documents.
248 * @var tslib_feUserAuth
251 var $loginUser=''; // Global flag indicating that a front-end user is logged in. This is set only if a user really IS logged in. The group-list may show other groups (like added by IP filter or so) even though there is no user.
252 var $gr_list=''; // (RO=readonly) The group list, sorted numerically. Group '0,-1' is the default group, but other groups may be added by other means than a user being logged in though...
253 var $beUserLogin=''; // Flag that indicates if a Backend user is logged in!
254 var $workspacePreview=''; // Integer, that indicates which workspace is being previewed.
255 var $loginAllowedInBranch = TRUE; // Shows whether logins are allowed in branch
256 var $ADMCMD_preview_BEUSER_uid = 0; // Integer, set to backend user ID to initialize when keyword-based preview is used.
259 var $fePreview=''; // Flag indication that preview is active. This is based on the login of a backend user and whether the backend user has read access to the current page. A value of 1 means ordinary preview, 2 means preview of a non-live workspace
260 var $showHiddenPage=''; // Flag indicating that hidden pages should be shown, selected and so on. This goes for almost all selection of pages!
261 var $showHiddenRecords=''; // Flag indicating that hidden records should be shown. This includes sys_template, pages_language_overlay and even fe_groups in addition to all other regular content. So in effect, this includes everything except pages.
262 var $simUserGroup='0'; // Value that contains the simulated usergroup if any
265 var $TYPO3_CONF_VARS=array(); // The configuration array as set up in t3lib/config_default.php. Should be an EXACT copy of the global array.
266 var $config=''; // "CONFIG" object from TypoScript. Array generated based on the TypoScript configuration of the current page. Saved with the cached pages.
267 var $TCAcachedExtras=array(); // Array of cached information from TCA. This is NOT TCA itself!
272 * The TypoScript template object. Used to parse the TypoScript template
274 * @var t3lib_TStemplate
277 var $cacheTimeOutDefault=''; // Is set to the time-to-live time of cached pages. If false, default is 60*60*24, which is 24 hours.
278 var $cacheContentFlag = 0; // Set internally if cached content is fetched from the database
279 var $cacheExpires=0; // Set to the expire time of cached content
280 var $isClientCachable=FALSE; // Set if cache headers allowing caching are sent.
281 var $all=''; // $all used by template fetching system. This array is an identification of the template. If $this->all is empty it's because the template-data is not cached, which it must be.
282 var $sPre=''; // toplevel - objArrayName, eg 'page'
283 var $pSetup=''; // TypoScript configuration of the page-object pointed to by sPre. $this->tmpl->setup[$this->sPre.'.']
284 var $newHash=''; // This hash is unique to the template, the $this->id and $this->type vars and the gr_list (list of groups). Used to get and later store the cached data
285 var $getMethodUrlIdToken=''; // If config.ftu (Frontend Track User) is set in TypoScript for the current page, the string value of this var is substituted in the rendered source-code with the string, '&ftu=[token...]' which enables GET-method usertracking as opposed to cookie based
286 var $no_CacheBeforePageGen=''; // This flag is set before inclusion of pagegen.php IF no_cache is set. If this flag is set after the inclusion of pagegen.php, no_cache is forced to be set. This is done in order to make sure that php-code from pagegen does not falsely clear the no_cache flag.
287 var $tempContent = FALSE; // This flag indicates if temporary content went into the cache during page-generation.
288 var $forceTemplateParsing=''; // Boolean, passed to TypoScript template class and tells it to render the template forcibly
289 var $cHash_array=array(); // The array which cHash_calc is based on, see ->makeCacheHash().
290 var $hash_base=''; // Loaded with the serialized array that is used for generating a hashstring for the cache
291 var $pagesTSconfig=''; // May be set to the pagesTSconfig
292 // PAGE-GENERATION / cOBJ
294 Eg. insert JS-functions in this array ($additionalHeaderData) to include them once. Use associative keys.
296 JSFormValidate : <script type="text/javascript" src="'.$GLOBALS["TSFE"]->absRefPrefix.'t3lib/jsfunc.validateform.js"></script>
297 JSincludeFormupdate : <script type="text/javascript" src="t3lib/jsfunc.updateform.js"></script>
298 JSMenuCode, JSMenuCode_menu : JavaScript for the JavaScript menu
302 var $additionalHeaderData=array(); // used to accumulate additional HTML-code for the header-section, <head>...</head>. Insert either associative keys (like additionalHeaderData['myStyleSheet'], see reserved keys above) or num-keys (like additionalHeaderData[] = '...')
303 var $additionalJavaScript=array(); // used to accumulate additional JavaScript-code. Works like additionalHeaderData. Reserved keys at 'openPic' and 'mouseOver'
304 var $additionalCSS=array(); // used to accumulate additional Style code. Works like additionalHeaderData.
305 var $JSeventFuncCalls = array( // you can add JavaScript functions to each entry in these arrays. Please see how this is done in the GMENU_LAYERS script. The point is that many applications on a page can set handlers for onload, onmouseover and onmouseup
306 'onmousemove' => array(),
307 'onmouseup' => array(),
308 'onmousemove' => array(),
309 'onkeydown' => array(),
310 'onkeyup' => array(),
311 'onkeypress' => array(),
313 'onunload' => array(),
316 * Adds JavaScript code
319 * @deprecated since TYPO3 3.5 - use additionalJavaScript instead.
322 var $JSImgCode=''; // Used to accumulate JavaScript loaded images (by menus)
323 var $divSection=''; // Used to accumulate DHTML-layers.
324 var $defaultBodyTag='<body>'; // Default bodytag, if nothing else is set. This can be overridden by applications like TemplaVoila.
326 // RENDERING configuration, settings from TypoScript is loaded into these vars. See pagegen.php
327 var $debug=''; // Debug flag, may output special debug html-code.
328 var $intTarget=''; // Default internal target
329 var $extTarget=''; // Default external target
330 var $fileTarget=''; // Default file link target
331 var $MP_defaults=array(); // Keys are page ids and values are default &MP (mount point) values to set when using the linking features...)
332 var $spamProtectEmailAddresses=0; // If set, typolink() function encrypts email addresses. Is set in pagegen-class.
333 var $absRefPrefix=''; // Absolute Reference prefix
334 var $absRefPrefix_force=0; // Absolute Reference prefix force flag. This is set, if the type and id is retrieve from PATH_INFO and thus we NEED to prefix urls with at least '/'
335 var $compensateFieldWidth=''; // Factor for form-field widths compensation
336 var $lockFilePath=''; // Lock file path
337 var $ATagParams=''; // <A>-tag parameters
338 var $sWordRegEx=''; // Search word regex, calculated if there has been search-words send. This is used to mark up the found search words on a page when jumped to from a link in a search-result.
339 var $sWordList=''; // Is set to the incoming array sword_list in case of a page-view jumped to from a search-result.
340 var $linkVars=''; // A string prepared for insertion in all links on the page as url-parameters. Based on configuration in TypoScript where you defined which GET_VARS you would like to pass on.
341 var $excludeCHashVars=''; // A string set with a comma list of additional GET vars which should NOT be included in the cHash calculation. These vars should otherwise be detected and involved in caching, eg. through a condition in TypoScript.
342 var $displayEditIcons=''; // If set, edit icons are rendered aside content records. Must be set only if the ->beUserLogin flag is set and set_no_cache() must be called as well.
343 var $displayFieldEditIcons=''; // If set, edit icons are rendered aside individual fields of content. Must be set only if the ->beUserLogin flag is set and set_no_cache() must be called as well.
344 var $sys_language_uid=0; // Site language, 0 (zero) is default, int+ is uid pointing to a sys_language record. Should reflect which language menus, templates etc is displayed in (master language) - but not necessarily the content which could be falling back to default (see sys_language_content)
345 var $sys_language_mode=''; // Site language mode for content fall back.
346 var $sys_language_content=0; // Site content selection uid (can be different from sys_language_uid if content is to be selected from a fall-back language. Depends on sys_language_mode)
347 var $sys_language_contentOL=0; // Site content overlay flag; If set - and sys_language_content is > 0 - , records selected will try to look for a translation pointing to their uid. (If configured in [ctrl][languageField] / [ctrl][transOrigP...]
348 var $sys_language_isocode = ''; // Is set to the iso code of the sys_language_content if that is properly defined by the sys_language record representing the sys_language_uid. (Requires the extension "static_info_tables")
351 var $applicationData=Array(); // 'Global' Storage for various applications. Keys should be 'tx_'.extKey for extensions.
352 var $register=Array();
353 var $registerStack=Array(); // Stack used for storing array and retrieving register arrays (see LOAD_REGISTER and CLEAR_REGISTER)
354 var $cObjectDepthCounter = 50; // Checking that the function is not called eternally. This is done by interrupting at a depth of 50
355 var $recordRegister = Array(); // used by cObj->RECORDS and cObj->CONTENT to ensure the a records is NOT rendered twice through it!
356 var $currentRecord = ''; // This is set to the [table]:[uid] of the latest record rendered. Note that class tslib_cObj has an equal value, but that is pointing to the record delivered in the $data-array of the tslib_cObj instance, if the cObjects CONTENT or RECORD created that instance
357 var $accessKey =array(); // Used by class tslib_menu to keep track of access-keys.
358 var $imagesOnPage=array(); // Numerical array where image filenames are added if they are referenced in the rendered document. This includes only TYPO3 generated/inserted images.
359 var $lastImageInfo=array(); // Is set in tslib_cObj->cImage() function to the info-array of the most recent rendered image. The information is used in tslib_cObj->IMGTEXT
360 var $uniqueCounter=0; // Used to generate page-unique keys. Point is that uniqid() functions is very slow, so a unikey key is made based on this, see function uniqueHash()
361 var $uniqueString='';
362 var $indexedDocTitle=''; // This value will be used as the title for the page in the indexer (if indexing happens)
363 var $altPageTitle=''; // Alternative page title (normally the title of the page record). Can be set from applications you make.
365 * An array that holds parameter names (keys) of GET parameters which MAY be MD5/base64 encoded with simulate_static_documents method.
367 * @deprecated since TYPO3 4.3, remove in TYPO3 4.5
369 var $pEncAllowedParamNames=array();
370 var $baseUrl=''; // The base URL set for the page header.
371 var $anchorPrefix=''; // The proper anchor prefix needed when using speaking urls. (only set if baseUrl is set)
374 * Page content render object
380 // CONTENT accumulation
381 var $content=''; // All page content is accumulated in this variable. See pagegen.php
384 var $clientInfo=''; // Set to the browser: net / msie if 4+ browsers
385 var $scriptParseTime=0;
386 var $TCAloaded = 0; // Set ONLY if the full TCA is loaded
388 // Character set (charset) conversion object:
391 * charset conversion class. May be used by any application.
396 var $defaultCharSet = 'iso-8859-1'; // The default charset used in the frontend if nothing else is set.
397 var $renderCharset=''; // Internal charset of the frontend during rendering: Defaults to "forceCharset" and if that is not set, to ->defaultCharSet
398 var $metaCharset=''; // Output charset of the websites content. This is the charset found in the header, meta tag etc. If different from $renderCharset a conversion happens before output to browser. Defaults to ->renderCharset if not set.
399 var $localeCharset=''; // Assumed charset of locale strings.
402 var $lang=''; // Set to the system language key (used on the site)
403 var $langSplitIndex=0; // Set to the index number of the language key
404 var $LL_labels_cache=array();
405 var $LL_files_cache=array();
412 var $pagesection_lockObj; // Locking object for accessing "cache_pagesection"
419 var $pages_lockObj; // Locking object for accessing "cache_pages"
422 * the page cache object, use this to save pages to the cache and to
423 * retrieve them again
425 * @var t3lib_cache_AbstractBackend
427 protected $pageCache;
428 protected $pageCacheTags = array();
433 * Takes a number of GET/POST input variable as arguments and stores them internally.
434 * The processing of these variables goes on later in this class.
435 * Also sets internal clientInfo array (browser information) and a unique string (->uniqueString) for this script instance; A md5 hash of the microtime()
437 * @param array The global $TYPO3_CONF_VARS array. Will be set internally in ->TYPO3_CONF_VARS
438 * @param mixed The value of t3lib_div::_GP('id')
439 * @param integer The value of t3lib_div::_GP('type')
440 * @param boolean The value of t3lib_div::_GP('no_cache'), evaluated to 1/0
441 * @param string The value of t3lib_div::_GP('cHash')
442 * @param string The value of t3lib_div::_GP('jumpurl')
443 * @param string The value of t3lib_div::_GP('MP')
444 * @param string The value of t3lib_div::_GP('RDCT')
448 function tslib_fe($TYPO3_CONF_VARS, $id, $type, $no_cache='', $cHash='', $jumpurl='',$MP='',$RDCT='') {
450 // Setting some variables:
451 $this->TYPO3_CONF_VARS
= $TYPO3_CONF_VARS;
455 if ($this->TYPO3_CONF_VARS
['FE']['disableNoCacheParameter']) {
456 $warning = '&no_cache=1 has been ignored because $TYPO3_CONF_VARS[\'FE\'][\'disableNoCacheParameter\'] is set!';
457 $GLOBALS['TT']->setTSlogMessage($warning,2);
459 $warning = '&no_cache=1 has been supplied, so caching is disabled! URL: "'.t3lib_div
::getIndpEnv('TYPO3_REQUEST_URL').'"';
460 $this->no_cache
= $no_cache ?
1 : 0;
462 t3lib_div
::sysLog($warning, 'cms', 2);
464 $this->cHash
= $cHash;
465 $this->jumpurl
= $jumpurl;
466 $this->MP
= $this->TYPO3_CONF_VARS
['FE']['enable_mount_pids'] ?
(string)$MP : '';
468 $this->clientInfo
= t3lib_div
::clientInfo();
469 $this->uniqueString
=md5(microtime());
471 $this->csConvObj
= t3lib_div
::makeInstance('t3lib_cs');
473 // Call post processing function for constructor:
474 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['tslib_fe-PostProc'])) {
475 $_params = array('pObj' => &$this);
476 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['tslib_fe-PostProc'] as $_funcRef) {
477 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
485 * Connect to MySQL database
486 * May exit after outputting an error message or some JavaScript redirecting to the install tool.
489 * @deprecated since TYPO3 3.8 - Use connectToDB() instead!
491 function connectToMySQL() {
492 $this->connectToDB();
496 * Connect to SQL database
497 * May exit after outputting an error message or some JavaScript redirecting to the install tool.
501 function connectToDB() {
502 if ($GLOBALS['TYPO3_DB']->sql_pconnect(TYPO3_db_host
, TYPO3_db_username
, TYPO3_db_password
)) {
504 $this->printError('No database selected','Database Error');
505 // Redirects to the Install Tool:
506 echo '<script type="text/javascript">
508 window.location.href = "'.TYPO3_mainDir
.'install/index.php?mode=123&step=1&password=joh316";
512 } elseif (!$GLOBALS['TYPO3_DB']->sql_select_db(TYPO3_db
)) {
513 if ($this->checkPageUnavailableHandler()) {
514 $this->pageUnavailableAndExit('Cannot connect to the current database, "'.TYPO3_db
.'"');
516 $message = 'Cannot connect to the current database, "'.TYPO3_db
.'"';
517 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
518 header('HTTP/1.0 503 Service Temporarily Unavailable');
519 $this->printError($message, 'Database Error');
525 // Redirects to the Install Tool:
526 echo '<script type="text/javascript">
528 window.location.href = "'.TYPO3_mainDir
.'install/index.php?mode=123&step=1&password=joh316";
534 if ($this->checkPageUnavailableHandler()) {
535 $this->pageUnavailableAndExit('The current username, password or host was not accepted when the connection to the database was attempted to be established!');
537 $message = 'The current username, password or host was not accepted when the connection to the database was attempted to be established!';
538 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
539 header('HTTP/1.0 503 Service Temporarily Unavailable');
540 $this->printError($message, 'Database Error');
546 // Call post processing function for DB connection:
547 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['connectToDB'])) {
548 $_params = array('pObj' => &$this);
549 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['connectToDB'] as $_funcRef) {
550 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
556 * Looks up the value of $this->RDCT in the database and if it is found to be associated with a redirect URL then the redirection is carried out with a 'Location:' header
557 * May exit after sending a location-header.
561 function sendRedirect() {
562 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('params', 'cache_md5params', 'md5hash='.$GLOBALS['TYPO3_DB']->fullQuoteStr($this->RDCT
, 'cache_md5params'));
563 if ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
564 $this->updateMD5paramsRecord($this->RDCT
);
565 header('Location: '.$row['params']);
587 /********************************************
589 * Initializing, resolving page id
591 ********************************************/
594 * Include files necessary for the TYPO3 caching framework. This method will
595 * go away when autoloading is implemented.
599 protected function includeCaches() {
600 $GLOBALS['TT']->push('Including the Caching System','');
602 t3lib_div
::requireOnce(PATH_t3lib
. 'class.t3lib_cache.php');
604 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/backend/interfaces/interface.t3lib_cache_backend_backend.php');
605 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/frontend/interfaces/interface.t3lib_cache_frontend_frontend.php');
607 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/backend/class.t3lib_cache_backend_abstractbackend.php');
608 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/frontend/class.t3lib_cache_frontend_abstractfrontend.php');
609 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/class.t3lib_cache_exception.php');
610 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/class.t3lib_cache_factory.php');
611 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/class.t3lib_cache_manager.php');
612 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/frontend/class.t3lib_cache_frontend_variablefrontend.php');
614 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_classalreadyloaded.php');
615 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_duplicateidentifier.php');
616 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_invalidbackend.php');
617 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_invalidcache.php');
618 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_invaliddata.php');
619 t3lib_div
::requireOnce(PATH_t3lib
. 'cache/exception/class.t3lib_cache_exception_nosuchcache.php');
621 $GLOBALS['TT']->pull();
625 * Initializes the caching system.
629 protected function initCaches() {
630 $this->includeCaches();
632 $GLOBALS['TT']->push('Initializing the Caching System','');
634 $GLOBALS['typo3CacheManager'] = t3lib_div
::makeInstance('t3lib_cache_Manager');
635 $GLOBALS['typo3CacheFactory'] = t3lib_div
::makeInstance('t3lib_cache_Factory');
636 $GLOBALS['typo3CacheFactory']->setCacheManager($GLOBALS['typo3CacheManager']);
639 $this->pageCache
= $GLOBALS['typo3CacheManager']->getCache(
642 } catch(t3lib_cache_exception_NoSuchCache
$e) {
643 t3lib_cache
::initPageCache();
645 $this->pageCache
= $GLOBALS['typo3CacheManager']->getCache(
650 t3lib_cache
::initPageSectionCache();
651 t3lib_cache
::initContentHashCache();
653 $GLOBALS['TT']->pull();
657 * Initializes the front-end login user.
661 function initFEuser() {
662 $this->fe_user
= t3lib_div
::makeInstance('tslib_feUserAuth');
664 $this->fe_user
->lockIP
= $this->TYPO3_CONF_VARS
['FE']['lockIP'];
665 $this->fe_user
->lockHashKeyWords
= $this->TYPO3_CONF_VARS
['FE']['lockHashKeyWords'];
666 $this->fe_user
->checkPid
= $this->TYPO3_CONF_VARS
['FE']['checkFeUserPid'];
667 $this->fe_user
->lifetime
= intval($this->TYPO3_CONF_VARS
['FE']['lifetime']);
668 $this->fe_user
->checkPid_value
= $GLOBALS['TYPO3_DB']->cleanIntList(t3lib_div
::_GP('pid')); // List of pid's acceptable
670 // Check if a session is transferred:
671 if (t3lib_div
::_GP('FE_SESSION_KEY')) {
672 $fe_sParts = explode('-',t3lib_div
::_GP('FE_SESSION_KEY'));
673 if (!strcmp(md5($fe_sParts[0].'/'.$this->TYPO3_CONF_VARS
['SYS']['encryptionKey']), $fe_sParts[1])) { // If the session key hash check is OK:
674 $_COOKIE[$this->fe_user
->name
] = $fe_sParts[0];
675 $this->fe_user
->forceSetCookie
= 1;
679 if ($this->TYPO3_CONF_VARS
['FE']['dontSetCookie']) {
680 $this->fe_user
->dontSetCookie
=1;
683 $this->fe_user
->start();
684 $this->fe_user
->unpack_uc('');
685 $this->fe_user
->fetchSessionData(); // Gets session data
686 $recs = t3lib_div
::_GP('recs');
687 if (is_array($recs)) { // If any record registration is submitted, register the record.
688 $this->fe_user
->record_registration($recs, $this->TYPO3_CONF_VARS
['FE']['maxSessionDataSize']);
691 // Call hook for possible manipulation of frontend user object
692 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['initFEuser'])) {
693 $_params = array('pObj' => &$this);
694 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['initFEuser'] as $_funcRef) {
695 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
699 // For every 60 seconds the is_online timestamp is updated.
700 if (is_array($this->fe_user
->user
) && $this->fe_user
->user
['uid'] && $this->fe_user
->user
['is_online']<($GLOBALS['EXEC_TIME']-60)) {
701 $GLOBALS['TYPO3_DB']->exec_UPDATEquery('fe_users', 'uid='.intval($this->fe_user
->user
['uid']), array('is_online' => $GLOBALS['EXEC_TIME']));
706 * Initializes the front-end user groups.
707 * Sets ->loginUser and ->gr_list based on front-end user status.
711 function initUserGroups() {
713 $this->fe_user
->showHiddenRecords
= $this->showHiddenRecords
; // This affects the hidden-flag selecting the fe_groups for the user!
714 $this->fe_user
->fetchGroupData(); // no matter if we have an active user we try to fetch matching groups which can be set without an user (simulation for instance!)
716 if (is_array($this->fe_user
->user
) && count($this->fe_user
->groupData
['uid'])) {
717 $this->loginUser
=1; // global flag!
718 $this->gr_list
= '0,-2'; // group -2 is not an existing group, but denotes a 'default' group when a user IS logged in. This is used to let elements be shown for all logged in users!
719 $gr_array = $this->fe_user
->groupData
['uid'];
722 $this->gr_list
= '0,-1'; // group -1 is not an existing group, but denotes a 'default' group when not logged in. This is used to let elements be hidden, when a user is logged in!
724 if ($this->loginAllowedInBranch
) {
725 $gr_array = $this->fe_user
->groupData
['uid']; // For cases where logins are not banned from a branch usergroups can be set based on IP masks so we should add the usergroups uids.
727 $gr_array = array(); // Set to blank since we will NOT risk any groups being set when no logins are allowed!
732 $gr_array = array_unique($gr_array); // Make unique...
733 sort($gr_array); // sort
734 if (count($gr_array)) {
735 $this->gr_list
.=','.implode(',',$gr_array);
738 if ($this->fe_user
->writeDevLog
) t3lib_div
::devLog('Valid usergroups for TSFE: '.$this->gr_list
, 'tslib_fe');
742 * Checking if a user is logged in or a group constellation different from "0,-1"
744 * @return boolean TRUE if either a login user is found (array fe_user->user) OR if the gr_list is set to something else than '0,-1' (could be done even without a user being logged in!)
746 function isUserOrGroupSet() {
747 return is_array($this->fe_user
->user
) ||
$this->gr_list
!=='0,-1';
751 * Provides ways to bypass the '?id=[xxx]&type=[xx]' format, using either PATH_INFO or virtual HTML-documents (using Apache mod_rewrite)
754 * 1) Use PATH_INFO (also Apache) to extract id and type from that var. Does not require any special modules compiled with apache. (less typical)
755 * 2) Using hook which enables features like those provided from "simulatestatic" or "realurl" extension (AKA "Speaking URLs")
758 * @link http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=270&cHash=4ad9d7acb4
760 function checkAlternativeIdMethods() {
761 $this->siteScript
= t3lib_div
::getIndpEnv('TYPO3_SITE_SCRIPT');
763 // Call post processing function for custom URL methods.
764 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkAlternativeIdMethods-PostProc'])) {
765 $_params = array('pObj' => &$this);
766 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkAlternativeIdMethods-PostProc'] as $_funcRef) {
767 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
773 * Clears the preview-flags, sets sim_exec_time to current time.
774 * Hidden pages must be hidden as default, $GLOBALS['SIM_EXEC_TIME'] is set to $GLOBALS['EXEC_TIME'] in t3lib/config_default.inc. Alter it by adding or subtracting seconds.
778 function clear_preview() {
779 $this->showHiddenPage
= 0;
780 $this->showHiddenRecords
= 0;
781 $GLOBALS['SIM_EXEC_TIME'] = $GLOBALS['EXEC_TIME'];
782 $GLOBALS['SIM_ACCESS_TIME'] = $GLOBALS['ACCESS_TIME'];
783 $this->fePreview
= 0;
787 * Determines the id and evaluates any preview settings
788 * Basically this function is about determining whether a backend user is logged in, if he has read access to the page and if he's previewing the page. That all determines which id to show and how to initialize the id.
792 function determineId() {
794 // Getting ARG-v values if some
795 $this->setIDfromArgV();
797 // If there is a Backend login we are going to check for any preview settings:
798 $GLOBALS['TT']->push('beUserLogin','');
799 if ($this->beUserLogin ||
$this->doWorkspacePreview()) {
801 // Backend user preview features:
802 if ($this->beUserLogin
&& ($GLOBALS['BE_USER']->frontendEdit
instanceof t3lib_frontendedit
)) {
803 $this->fePreview
= $GLOBALS['BE_USER']->frontendEdit
->extGetFeAdminValue('preview') ?
true : false;
805 // If admin panel preview is enabled...
806 if ($this->fePreview
) {
807 $fe_user_OLD_USERGROUP = $this->fe_user
->user
['usergroup'];
809 $this->showHiddenPage
= $GLOBALS['BE_USER']->frontendEdit
->extGetFeAdminValue('preview', 'showHiddenPages');
810 $this->showHiddenRecords
= $GLOBALS['BE_USER']->frontendEdit
->extGetFeAdminValue('preview', 'showHiddenRecords');
812 $simTime = $GLOBALS['BE_USER']->frontendEdit
->extGetFeAdminValue('preview', 'simulateDate');
814 $GLOBALS['SIM_EXEC_TIME'] = $simTime;
815 $GLOBALS['SIM_ACCESS_TIME'] = $simTime - ($simTime %
60);
818 $simUserGroup = $GLOBALS['BE_USER']->frontendEdit
->extGetFeAdminValue('preview', 'simulateUserGroup');
819 $this->simUserGroup
= $simUserGroup;
820 if ($simUserGroup) $this->fe_user
->user
['usergroup']=$simUserGroup;
821 if (!$simUserGroup && !$simTime && !$this->showHiddenPage
&& !$this->showHiddenRecords
) {
829 // Now it's investigated if the raw page-id points to a hidden page and if so, the flag is set.
830 // This does not require the preview flag to be set in the admin panel
831 $idQ = t3lib_div
::testInt($this->id
) ?
'uid='.intval($this->id
) : 'alias='.$GLOBALS['TYPO3_DB']->fullQuoteStr($this->id
, 'pages').' AND pid>=0'; // pid>=0 added for the sake of versioning...
832 $count = $GLOBALS['TYPO3_DB']->exec_SELECTcountRows('uid', 'pages', $idQ . ' AND hidden!=0 AND deleted=0');
834 $this->fePreview
= 1; // The preview flag is set only if the current page turns out to actually be hidden!
835 $this->showHiddenPage
= 1;
838 // For Live workspace: Check root line for proper connection to tree root (done because of possible preview of page / branch versions)
839 if (!$this->fePreview
&& $this->whichWorkspace()===0) {
841 // Initialize the page-select functions to check rootline:
842 $temp_sys_page = t3lib_div
::makeInstance('t3lib_pageSelect');
843 $temp_sys_page->init($this->showHiddenPage
);
844 // If root line contained NO records and ->error_getRootLine_failPid tells us that it was because of a pid=-1 (indicating a "version" record)...:
845 if (!count($temp_sys_page->getRootLine($this->id
,$this->MP
)) && $temp_sys_page->error_getRootLine_failPid
==-1) {
847 // Setting versioningPreview flag and try again:
848 $temp_sys_page->versioningPreview
= TRUE;
849 if (count($temp_sys_page->getRootLine($this->id
,$this->MP
))) {
850 // Finally, we got a root line (meaning that it WAS due to versioning preview of a page somewhere) and we set the fePreview flag which in itself will allow sys_page class to display previews of versionized records.
851 $this->fePreview
= 1;
857 // The preview flag will be set if a backend user is in an offline workspace
858 if (($GLOBALS['BE_USER']->user
['workspace_preview'] || t3lib_div
::_GP('ADMCMD_view') ||
$this->doWorkspacePreview()) && ($this->whichWorkspace()===-1 ||
$this->whichWorkspace()>0)) {
859 $this->fePreview
= 2; // Will show special preview message.
862 // If the front-end is showing a preview, caching MUST be disabled.
863 if ($this->fePreview
) {
864 $this->set_no_cache();
867 $GLOBALS['TT']->pull();
869 // Now, get the id, validate access etc:
870 $this->fetch_the_id();
872 // Check if backend user has read access to this page. If not, recalculate the id.
873 if ($this->beUserLogin
&& $this->fePreview
) {
874 if (!$GLOBALS['BE_USER']->doesUserHaveAccess($this->page
,1)) {
877 $this->clear_preview();
878 $this->fe_user
->user
['usergroup'] = $fe_user_OLD_USERGROUP;
880 // Fetching the id again, now with the preview settings reset.
881 $this->fetch_the_id();
885 // Checks if user logins are blocked for a certain branch and if so, will unset user login and re-fetch ID.
886 $this->loginAllowedInBranch
= $this->checkIfLoginAllowedInBranch();
887 if (!$this->loginAllowedInBranch
) { // Logins are not allowed:
888 if ($this->isUserOrGroupSet()) { // Only if there is a login will we run this...
890 // Clear out user and group:
891 unset($this->fe_user
->user
);
892 $this->gr_list
= '0,-1';
894 // Fetching the id again, now with the preview settings reset.
895 $this->fetch_the_id();
900 $this->id
= $this->contentPid
= intval($this->id
); // Make sure it's an integer
901 $this->type
= intval($this->type
); // Make sure it's an integer
903 // Look for alternative content PID if page is under version preview:
904 if ($this->fePreview
) {
905 if ($this->page
['_ORIG_pid']==-1 && $this->page
['t3ver_swapmode']==0) { // Current page must have been an offline version and have swapmode set to 0:
906 // Setting contentPid here for preview might not be completely correct to do. Strictly the "_ORIG_uid" value should be used for tables where "versioning_followPages" is set and for others not. However this is a working quick-fix to display content elements at least!
907 $this->contentPid
= $this->page
['_ORIG_uid'];
911 // Call post processing function for id determination:
912 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['determineId-PostProc'])) {
913 $_params = array('pObj' => &$this);
914 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['determineId-PostProc'] as $_funcRef) {
915 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
922 * This gets the id of the page, checks if the page is in the domain and if the page is accessible
923 * Sets variables such as $this->sys_page, $this->loginUser, $this->gr_list, $this->id, $this->type, $this->domainStartPage, $this->idParts
928 function fetch_the_id() {
929 $GLOBALS['TT']->push('fetch_the_id initialize/','');
931 // Initialize the page-select functions.
932 $this->sys_page
= t3lib_div
::makeInstance('t3lib_pageSelect');
933 $this->sys_page
->versioningPreview
= ($this->fePreview
===2 ||
intval($this->workspacePreview
) || t3lib_div
::_GP('ADMCMD_view')) ?
TRUE : FALSE;
934 $this->sys_page
->versioningWorkspaceId
= $this->whichWorkspace();
935 $this->sys_page
->init($this->showHiddenPage
);
937 // Set the valid usergroups for FE
938 $this->initUserGroups();
940 // Sets sys_page where-clause
941 $this->setSysPageWhereClause();
943 // Splitting $this->id by a period (.). First part is 'id' and second part - if exists - will overrule the &type param if given
944 $pParts = explode('.',$this->id
);
945 $this->id
= $pParts[0]; // Set it.
946 if (isset($pParts[1])) {$this->type
=$pParts[1];}
948 // Splitting $this->id by a comma (,). First part is 'id' and other parts are just stored for use in scripts.
949 $this->idParts
= explode(',',$this->id
);
951 // Splitting by a '+' sign - used for base64/md5 methods of parameter encryption for simulate static documents.
952 list($pgID,$SSD_p)=explode('+',$this->idParts
[0],2);
953 if ($SSD_p) { $this->idPartsAnalyze($SSD_p); }
954 $this->id
= $pgID; // Set id
956 // If $this->id is a string, it's an alias
957 $this->checkAndSetAlias();
959 // The id and type is set to the integer-value - just to be sure...
960 $this->id
= intval($this->id
);
961 $this->type
= intval($this->type
);
962 $GLOBALS['TT']->pull();
964 // We find the first page belonging to the current domain
965 $GLOBALS['TT']->push('fetch_the_id domain/','');
966 $this->domainStartPage
= $this->findDomainRecord($this->TYPO3_CONF_VARS
['SYS']['recursiveDomainSearch']); // the page_id of the current domain
968 if ($this->domainStartPage
) {
969 $this->id
= $this->domainStartPage
; // If the id was not previously set, set it to the id of the domain.
971 $theFirstPage = $this->sys_page
->getFirstWebPage($this->id
); // Find the first 'visible' page in that domain
973 $this->id
= $theFirstPage['uid'];
975 if ($this->checkPageUnavailableHandler()) {
976 $this->pageUnavailableAndExit('No pages are found on the rootlevel!');
978 $message = 'No pages are found on the rootlevel!';
979 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
980 header('HTTP/1.0 503 Service Temporarily Unavailable');
981 $this->printError($message);
987 $GLOBALS['TT']->pull();
989 $GLOBALS['TT']->push('fetch_the_id rootLine/','');
990 $requestedId = $this->id
; // We store the originally requested id
991 $this->getPageAndRootlineWithDomain($this->domainStartPage
);
992 $GLOBALS['TT']->pull();
994 if ($this->pageNotFound
&& $this->TYPO3_CONF_VARS
['FE']['pageNotFound_handling']) {
995 $pNotFoundMsg = array(
996 1 => 'ID was not an accessible page',
997 2 => 'Subsection was found and not accessible',
998 3 => 'ID was outside the domain',
999 4 => 'The requested page alias does not exist'
1001 $this->pageNotFoundAndExit($pNotFoundMsg[$this->pageNotFound
]);
1004 // set no_cache if set
1005 if ($this->page
['no_cache']) {
1006 $this->set_no_cache();
1009 // Init SYS_LASTCHANGED
1010 $this->register
['SYS_LASTCHANGED'] = intval($this->page
['tstamp']);
1011 if ($this->register
['SYS_LASTCHANGED'] < intval($this->page
['SYS_LASTCHANGED'])) {
1012 $this->register
['SYS_LASTCHANGED'] = intval($this->page
['SYS_LASTCHANGED']);
1017 * Gets the page and rootline arrays based on the id, $this->id
1019 * If the id does not correspond to a proper page, the 'previous' valid page in the rootline is found
1020 * If the page is a shortcut (doktype=4), the ->id is loaded with that id
1022 * Whether or not the ->id is changed to the shortcut id or the previous id in rootline (eg if a page is hidden), the ->page-array and ->rootline is found and must also be valid.
1024 * Sets or manipulates internal variables such as: $this->id, $this->page, $this->rootLine, $this->MP, $this->pageNotFound
1029 function getPageAndRootline() {
1030 $this->page
= $this->sys_page
->getPage($this->id
);
1031 if (!count($this->page
)) {
1032 // If no page, we try to find the page before in the rootLine.
1033 $this->pageNotFound
=1; // Page is 'not found' in case the id itself was not an accessible page. code 1
1034 $this->rootLine
= $this->sys_page
->getRootLine($this->id
,$this->MP
);
1035 if (count($this->rootLine
)) {
1036 $c=count($this->rootLine
)-1;
1039 // Add to page access failure history:
1040 $this->pageAccessFailureHistory
['direct_access'][] = $this->rootLine
[$c];
1042 // Decrease to next page in rootline and check the access to that, if OK, set as page record and ID value.
1044 $this->id
= $this->rootLine
[$c]['uid'];
1045 $this->page
= $this->sys_page
->getPage($this->id
);
1046 if (count($this->page
)) { break; }
1049 // If still no page...
1050 if (!count($this->page
)) {
1051 if ($this->TYPO3_CONF_VARS
['FE']['pageNotFound_handling']) {
1052 $this->pageNotFoundAndExit('The requested page does not exist!');
1054 $message = 'The requested page does not exist!';
1055 header('HTTP/1.0 404 Page Not Found');
1056 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
1057 $this->printError($message);
1063 // Spacer is not accessible in frontend
1064 if ($this->page
['doktype'] == 199) {
1065 if ($this->TYPO3_CONF_VARS
['FE']['pageNotFound_handling']) {
1066 $this->pageNotFoundAndExit('The requested page does not exist!');
1068 $message = 'The requested page does not exist!';
1069 header('HTTP/1.0 404 Page Not Found');
1070 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
1071 $this->printError($message);
1076 // Is the ID a link to another page??
1077 if ($this->page
['doktype']==4) {
1078 $this->MP
= ''; // We need to clear MP if the page is a shortcut. Reason is if the short cut goes to another page, then we LEAVE the rootline which the MP expects.
1080 // saving the page so that we can check later - when we know
1081 // about languages - whether we took the correct shortcut or
1082 // whether a translation of the page overwrites the shortcut
1083 // target and we need to follow the new target
1084 $this->originalShortcutPage
= $this->page
;
1086 $this->page
= $this->getPageShortcut($this->page
['shortcut'],$this->page
['shortcut_mode'],$this->page
['uid']);
1087 $this->id
= $this->page
['uid'];
1090 // Gets the rootLine
1091 $this->rootLine
= $this->sys_page
->getRootLine($this->id
,$this->MP
);
1093 // If not rootline we're off...
1094 if (!count($this->rootLine
)) {
1095 $ws = $this->whichWorkspace();
1096 if ($this->sys_page
->error_getRootLine_failPid
==-1 && $ws) {
1097 $this->sys_page
->versioningPreview
= TRUE;
1098 $this->versioningWorkspaceId
= $ws;
1099 $this->rootLine
= $this->sys_page
->getRootLine($this->id
,$this->MP
);
1101 if (!count($this->rootLine
)) {
1102 if ($this->checkPageUnavailableHandler()) {
1103 $this->pageUnavailableAndExit('The requested page didn\'t have a proper connection to the tree-root!');
1105 $message = 'The requested page didn\'t have a proper connection to the tree-root! <br /><br />('.$this->sys_page
->error_getRootLine
.')';
1106 header('HTTP/1.0 503 Service Temporarily Unavailable');
1107 t3lib_div
::sysLog(str_replace('<br /><br />','',$message), 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
1108 $this->printError($message);
1112 $this->fePreview
= 1;
1115 // Checking for include section regarding the hidden/starttime/endtime/fe_user (that is access control of a whole subbranch!)
1116 if ($this->checkRootlineForIncludeSection()) {
1117 if (!count($this->rootLine
)) {
1118 if ($this->checkPageUnavailableHandler()) {
1119 $this->pageUnavailableAndExit('The requested page was not accessible!');
1121 $message = 'The requested page was not accessible!';
1122 header('HTTP/1.0 503 Service Temporarily Unavailable');
1123 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
1124 $this->printError($message);
1128 $el = reset($this->rootLine
);
1129 $this->id
= $el['uid'];
1130 $this->page
= $this->sys_page
->getPage($this->id
);
1131 $this->rootLine
= $this->sys_page
->getRootLine($this->id
,$this->MP
);
1137 * Get page shortcut; Finds the records pointed to by input value $SC (the shortcut value)
1139 * @param integer The value of the "shortcut" field from the pages record
1140 * @param integer The shortcut mode: 1 and 2 will select either first subpage or random subpage; the default is the page pointed to by $SC
1141 * @param integer The current page UID of the page which is a shortcut
1142 * @param integer Safety feature which makes sure that the function is calling itself recursively max 20 times (since this function can find shortcuts to other shortcuts to other shortcuts...)
1143 * @param array An array filled with previous page uids tested by the function - new page uids are evaluated against this to avoid going in circles.
1144 * @return mixed Returns the page record of the page that the shortcut pointed to.
1146 * @see getPageAndRootline()
1148 function getPageShortcut($SC,$mode,$thisUid,$itera=20,$pageLog=array()) {
1149 $idArray = t3lib_div
::intExplode(',',$SC);
1151 // Find $page record depending on shortcut mode:
1155 $pageArray = $this->sys_page
->getMenu($idArray[0]?
$idArray[0]:$thisUid,'*','sorting','AND pages.doktype<199 AND pages.doktype!=6');
1157 if ($mode==2 && count($pageArray)) { // random
1159 $randval = intval(rand(0,count($pageArray)-1));
1164 while(list(,$pV)=each($pageArray)) {
1173 $page = $this->sys_page
->getPage($idArray[0]);
1177 // Check if short cut page was a shortcut itself, if so look up recursively:
1178 if ($page['doktype']==4) {
1179 if (!in_array($page['uid'],$pageLog) && $itera>0) {
1180 $pageLog[] = $page['uid'];
1181 $page = $this->getPageShortcut($page['shortcut'],$page['shortcut_mode'],$page['uid'],$itera-1,$pageLog);
1183 $pageLog[] = $page['uid'];
1184 $message = 'Page shortcuts were looping in uids '.implode(',',$pageLog).'...!';
1185 header('HTTP/1.0 500 Internal Server Error');
1186 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
1187 $this->printError($message);
1191 // Return resulting page:
1196 * Checks the current rootline for defined sections.
1201 function checkRootlineForIncludeSection() {
1202 $c=count($this->rootLine
);
1203 $removeTheRestFlag=0;
1205 for ($a=0;$a<$c;$a++
) {
1206 if (!$this->checkPagerecordForIncludeSection($this->rootLine
[$a])) {
1207 // Add to page access failure history:
1208 $this->pageAccessFailureHistory
['sub_section'][] = $this->rootLine
[$a];
1209 $removeTheRestFlag=1;
1211 if ($this->rootLine
[$a]['doktype']==6) {
1212 if ($this->beUserLogin
) { // If there is a backend user logged in, check if he has read access to the page:
1213 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('uid', 'pages', 'uid='.intval($this->id
).' AND '.$GLOBALS['BE_USER']->getPagePermsClause(1)); // versionOL()?
1214 list($isPage) = $GLOBALS['TYPO3_DB']->sql_fetch_row($res);
1215 if (!$isPage) $removeTheRestFlag=1; // If there was no page selected, the user apparently did not have read access to the current PAGE (not position in rootline) and we set the remove-flag...
1216 } else { // Dont go here, if there is no backend user logged in.
1217 $removeTheRestFlag=1;
1220 if ($removeTheRestFlag) {
1221 $this->pageNotFound
=2; // Page is 'not found' in case a subsection was found and not accessible, code 2
1222 unset($this->rootLine
[$a]);
1225 return $removeTheRestFlag;
1229 * Checks page record for enableFields
1230 * Returns true if enableFields does not disable the page record.
1231 * Takes notice of the ->showHiddenPage flag and uses SIM_ACCESS_TIME for start/endtime evaluation
1233 * @param array The page record to evaluate (needs fields: hidden, starttime, endtime, fe_group)
1234 * @param boolean Bypass group-check
1235 * @return boolean True, if record is viewable.
1236 * @see tslib_cObj::getTreeList(), checkPagerecordForIncludeSection()
1238 function checkEnableFields($row,$bypassGroupCheck=FALSE) {
1239 if ((!$row['hidden'] ||
$this->showHiddenPage
)
1240 && $row['starttime']<=$GLOBALS['SIM_ACCESS_TIME']
1241 && ($row['endtime']==0 ||
$row['endtime']>$GLOBALS['SIM_ACCESS_TIME'])
1242 && ($bypassGroupCheck ||
$this->checkPageGroupAccess($row))
1247 * Check group access against a page record
1249 * @param array The page record to evaluate (needs field: fe_group)
1250 * @param mixed List of group id's (comma list or array). Default is $this->gr_list
1251 * @return boolean True, if group access is granted.
1254 function checkPageGroupAccess($row, $groupList=NULL) {
1255 if(is_null($groupList)) {
1256 $groupList = $this->gr_list
;
1258 if(!is_array($groupList)) {
1259 $groupList = explode(',', $groupList);
1261 $pageGroupList = explode(',', $row['fe_group'] ?
$row['fe_group'] : 0);
1262 return count(array_intersect($groupList, $pageGroupList)) > 0;
1266 * Checks page record for include section
1268 * @param array The page record to evaluate (needs fields: extendToSubpages + hidden, starttime, endtime, fe_group)
1269 * @return boolean Returns true if either extendToSubpages is not checked or if the enableFields does not disable the page record.
1271 * @see checkEnableFields(), tslib_cObj::getTreeList(), checkRootlineForIncludeSection()
1273 function checkPagerecordForIncludeSection($row) {
1274 return (!$row['extendToSubpages'] ||
$this->checkEnableFields($row)) ?
1 : 0;
1278 * Checks if logins are allowed in the current branch of the page tree. Traverses the full root line and returns TRUE if logins are OK, otherwise false (and then the login user must be unset!)
1280 * @return boolean returns TRUE if logins are OK, otherwise false (and then the login user must be unset!)
1282 function checkIfLoginAllowedInBranch() {
1285 $c = count($this->rootLine
);
1288 // Traverse root line from root and outwards:
1289 for ($a=0; $a<$c; $a++
) {
1291 // If a value is set for login state:
1292 if ($this->rootLine
[$a]['fe_login_mode'] > 0) {
1294 // Determine state from value:
1295 $disable = (int)$this->rootLine
[$a]['fe_login_mode'] === 1 ?
TRUE : FALSE;
1303 * Analysing $this->pageAccessFailureHistory into a summary array telling which features disabled display and on which pages and conditions. That data can be used inside a page-not-found handler
1305 * @return array Summary of why page access was not allowed.
1307 function getPageAccessFailureReasons() {
1310 $combinedRecords = array_merge(
1311 is_array($this->pageAccessFailureHistory
['direct_access']) ?
$this->pageAccessFailureHistory
['direct_access'] : array(array('fe_group'=>0)), // Adding fake first record for direct access if none, otherwise $k==0 below will be indicating a sub-section record to be first direct_access record which is of course false!
1312 is_array($this->pageAccessFailureHistory
['sub_section']) ?
$this->pageAccessFailureHistory
['sub_section'] : array()
1315 if (count($combinedRecords)) {
1316 foreach($combinedRecords as $k => $pagerec) {
1317 // If $k=0 then it is the very first page the original ID was pointing at and that will get a full check of course
1318 // If $k>0 it is parent pages being tested. They are only significant for the access to the first page IF they had the extendToSubpages flag set, hence checked only then!
1319 if (!$k ||
$pagerec['extendToSubpages']) {
1320 if ($pagerec['hidden']) $output['hidden'][$pagerec['uid']] = TRUE;
1321 if ($pagerec['starttime'] > $GLOBALS['SIM_ACCESS_TIME']) $output['starttime'][$pagerec['uid']] = $pagerec['starttime'];
1322 if ($pagerec['endtime']!=0 && $pagerec['endtime'] <= $GLOBALS['SIM_ACCESS_TIME']) $output['endtime'][$pagerec['uid']] = $pagerec['endtime'];
1323 if (!$this->checkPageGroupAccess($pagerec)) $output['fe_group'][$pagerec['uid']] = $pagerec['fe_group'];
1332 * This checks if there are ARGV-parameters in the QUERY_STRING and if so, those are used for the id
1333 * $this->id must be 'false' in order for any processing to happen in here
1334 * If an id/alias value is extracted from the QUERY_STRING it is set in $this->id
1339 function setIDfromArgV() {
1341 list($theAlias) = explode('&',t3lib_div
::getIndpEnv('QUERY_STRING'));
1342 $theAlias = trim($theAlias);
1343 $this->id
= ($theAlias != '' && strpos($theAlias, '=') === false) ?
$theAlias : 0;
1348 * Gets ->page and ->rootline information based on ->id. ->id may change during this operation.
1349 * If not inside domain, then default to first page in domain.
1351 * @param integer Page uid of the page where the found domain record is (pid of the domain record)
1355 function getPageAndRootlineWithDomain($domainStartPage) {
1356 $this->getPageAndRootline();
1358 // Checks if the $domain-startpage is in the rootLine. This is necessary so that references to page-id's from other domains are not possible.
1359 if ($domainStartPage && is_array($this->rootLine
)) {
1360 reset ($this->rootLine
);
1362 while(list($key,$val)=each($this->rootLine
)) {
1363 if ($val['uid']==$domainStartPage) {
1369 $this->pageNotFound
=3; // Page is 'not found' in case the id was outside the domain, code 3
1370 $this->id
= $domainStartPage;
1371 $this->getPageAndRootline(); //re-get the page and rootline if the id was not found.
1377 * Sets sys_page where-clause
1382 function setSysPageWhereClause() {
1383 $this->sys_page
->where_hid_del
.=' AND pages.doktype<200';
1384 $this->sys_page
->where_groupAccess
= $this->sys_page
->getMultipleGroupsWhereClause('pages.fe_group', 'pages');
1388 * Looking up a domain record based on HTTP_HOST
1390 * @param boolean If set, it looks "recursively" meaning that a domain like "123.456.typo3.com" would find a domain record like "typo3.com" if "123.456.typo3.com" or "456.typo3.com" did not exist.
1391 * @return integer Returns the page id of the page where the domain record was found.
1394 function findDomainRecord($recursive=0) {
1396 $host = explode('.',t3lib_div
::getIndpEnv('HTTP_HOST'));
1397 while(count($host)) {
1398 $pageUid = $this->sys_page
->getDomainStartPage(implode('.',$host),t3lib_div
::getIndpEnv('SCRIPT_NAME'),t3lib_div
::getIndpEnv('REQUEST_URI'));
1399 if ($pageUid) return $pageUid; else array_shift($host);
1403 return $this->sys_page
->getDomainStartPage(t3lib_div
::getIndpEnv('HTTP_HOST'),t3lib_div
::getIndpEnv('SCRIPT_NAME'),t3lib_div
::getIndpEnv('REQUEST_URI'));
1408 * Page unavailable handler for use in frontend plugins from extensions.
1410 * @param string Reason text
1411 * @param string HTTP header to send
1412 * @return void Function exits.
1414 function pageUnavailableAndExit($reason='', $header='') {
1415 $header = $header ?
$header : $this->TYPO3_CONF_VARS
['FE']['pageUnavailable_handling_statheader'];
1416 $this->pageUnavailableHandler($this->TYPO3_CONF_VARS
['FE']['pageUnavailable_handling'], $header, $reason);
1421 * Page-not-found handler for use in frontend plugins from extensions.
1423 * @param string Reason text
1424 * @param string HTTP header to send
1425 * @return void Function exits.
1427 function pageNotFoundAndExit($reason='', $header='') {
1428 $header = $header ?
$header : $this->TYPO3_CONF_VARS
['FE']['pageNotFound_handling_statheader'];
1429 $this->pageNotFoundHandler($this->TYPO3_CONF_VARS
['FE']['pageNotFound_handling'], $header, $reason);
1434 * Checks whether the pageUnavailableHandler should be used. To be used, pageUnavailable_handling must be set
1435 * and devIPMask must not match the current visitor's IP address.
1437 * @return boolean True/false whether the pageUnavailable_handler should be used.
1439 function checkPageUnavailableHandler() {
1440 if($this->TYPO3_CONF_VARS
['FE']['pageUnavailable_handling'] &&
1441 !t3lib_div
::cmpIP(t3lib_div
::getIndpEnv('REMOTE_ADDR'), $this->TYPO3_CONF_VARS
['SYS']['devIPmask'])) {
1442 $checkPageUnavailableHandler = TRUE;
1444 $checkPageUnavailableHandler = FALSE;
1447 return $checkPageUnavailableHandler;
1451 * Page unavailable handler. Acts a wrapper for the pageErrorHandler method.
1453 * @param mixed Which type of handling; If a true PHP-boolean or TRUE then a ->printError message is outputted. If integer an error message with that number is shown. Otherwise the $code value is expected to be a "Location:" header value.
1454 * @param string If set, this is passed directly to the PHP function, header()
1455 * @param string If set, error messages will also mention this as the reason for the page-not-found.
1456 * @return void (The function exits!)
1458 function pageUnavailableHandler($code, $header, $reason) {
1459 $this->pageErrorHandler($code, $header, $reason);
1463 * Page not found handler. Acts a wrapper for the pageErrorHandler method.
1465 * @param mixed Which type of handling; If a true PHP-boolean or TRUE then a ->printError message is outputted. If integer an error message with that number is shown. Otherwise the $code value is expected to be a "Location:" header value.
1466 * @param string If set, this is passed directly to the PHP function, header()
1467 * @param string If set, error messages will also mention this as the reason for the page-not-found.
1468 * @return void (The function exits!)
1470 function pageNotFoundHandler($code, $header='', $reason='') {
1471 $this->pageErrorHandler($code, $header, $reason);
1475 * Generic error page handler.
1478 * @param mixed Which type of handling; If a true PHP-boolean or TRUE then a ->printError message is outputted. If integer an error message with that number is shown. Otherwise the $code value is expected to be a "Location:" header value.
1479 * @param string If set, this is passed directly to the PHP function, header()
1480 * @param string If set, error messages will also mention this as the reason for the page-not-found.
1481 * @return void (The function exits!)
1483 function pageErrorHandler($code, $header='', $reason='') {
1485 // Issue header in any case:
1487 $headerArr = preg_split('/\r|\n/',$header,-1,PREG_SPLIT_NO_EMPTY
);
1488 foreach ($headerArr as $header) {
1494 if (gettype($code)=='boolean' ||
!strcmp($code,1)) { // Simply boolean; Just shows TYPO3 error page with reason:
1495 $this->printError('The page did not exist or was inaccessible.'.($reason ?
' Reason: '.htmlspecialchars($reason) : ''));
1496 } elseif (t3lib_div
::isFirstPartOfStr($code,'USER_FUNCTION:')) {
1497 $funcRef = trim(substr($code,14));
1499 'currentUrl' => t3lib_div
::getIndpEnv('REQUEST_URI'),
1500 'reasonText' => $reason,
1501 'pageAccessFailureReasons' => $this->getPageAccessFailureReasons()
1503 echo t3lib_div
::callUserFunction($funcRef,$params,$this);
1504 } elseif (t3lib_div
::isFirstPartOfStr($code,'READFILE:')) {
1505 $readFile = t3lib_div
::getFileAbsFileName(trim(substr($code,9)));
1506 if (@is_file
($readFile)) {
1507 $fileContent = t3lib_div
::getUrl($readFile);
1508 $fileContent = str_replace('###CURRENT_URL###', t3lib_div
::getIndpEnv('REQUEST_URI'), $fileContent);
1509 $fileContent = str_replace('###REASON###', htmlspecialchars($reason), $fileContent);
1512 $this->printError('Configuration Error: 404 page "'.$readFile.'" could not be found.');
1514 } elseif (t3lib_div
::isFirstPartOfStr($code,'REDIRECT:')) {
1515 header('Location: '.t3lib_div
::locationHeaderUrl(substr($code,9)));
1517 } elseif (strlen($code)) {
1518 // Check if URL is relative
1519 $url_parts = parse_url($code);
1520 if ($url_parts['host'] == '') {
1521 $url_parts['host'] = t3lib_div
::getIndpEnv('HTTP_HOST');
1522 $code = t3lib_div
::getIndpEnv('TYPO3_REQUEST_HOST') . $code;
1523 $checkBaseTag = false;
1525 $checkBaseTag = true;
1529 if ($code == t3lib_div
::getIndpEnv('TYPO3_REQUEST_URL')) {
1530 if ($reason == '') {
1531 $reason = 'Page cannot be found.';
1533 $reason.= chr(10) . chr(10) . 'Additionally, ' . $code . ' was not found while trying to retrieve the error document.';
1534 $this->printError('Reason: '.nl2br(htmlspecialchars($reason)));
1540 'User-agent: ' . t3lib_div
::getIndpEnv('HTTP_USER_AGENT'),
1541 'Referer: ' . t3lib_div
::getIndpEnv('TYPO3_REQUEST_URL')
1543 $res = t3lib_div
::getURL($code, 1, $headerArr);
1545 // Header and content are separated by an empty line
1546 list($header, $content) = preg_split("/[\r\n\r\n]/", $res, 2);
1549 if (false === $res) {
1550 // Last chance -- redirect
1551 header('Location: '.t3lib_div
::locationHeaderUrl($code));
1554 $forwardHeaders = array( // Forward these response headers to the client
1557 $headerArr = preg_split('/\r|\n/',$header,-1,PREG_SPLIT_NO_EMPTY
);
1558 foreach ($headerArr as $header) {
1559 foreach ($forwardHeaders as $h) {
1560 if (preg_match('/^'.$h.'/', $header)) {
1565 // Put <base> if necesary
1566 if ($checkBaseTag) {
1568 // If content already has <base> tag, we do not need to do anything
1569 if (false === stristr($content, '<base ')) {
1571 // Generate href for base tag
1572 $base = $url_parts['scheme'] . '://';
1573 if ($url_parts['user'] != '') {
1574 $base.= $url_parts['user'];
1575 if ($url_parts['pass'] != '') {
1576 $base.= ':' . $url_parts['pass'];
1580 $base.= $url_parts['host'];
1582 // Add path portion skipping possible file name
1583 $base.= preg_replace('/(.*\/)[^\/]*/', '${1}', $url_parts['path']);
1585 // Put it into content (generate also <head> if necessary)
1586 $replacement = chr(10) . '<base href="' . htmlentities($base) . '" />' . chr(10);
1587 if (stristr($content, '<head>')) {
1588 $content = preg_replace('/(<head>)/i', '\1' . $replacement, $content);
1590 $content = preg_replace('/(<html[^>]*>)/i', '\1<head>' . $replacement . '</head>', $content);
1594 echo $content; // Output the content
1597 $this->printError($reason ?
'Reason: '.htmlspecialchars($reason) : 'Page cannot be found.');
1603 * Fetches the integer page id for a page alias.
1604 * Looks if ->id is not an integer and if so it will search for a page alias and if found the page uid of that page is stored in $this->id
1609 function checkAndSetAlias() {
1610 if ($this->id
&& !t3lib_div
::testInt($this->id
)) {
1611 $aid = $this->sys_page
->getPageIdFromAlias($this->id
);
1615 $this->pageNotFound
= 4;
1621 * Analyzes the second part of a id-string (after the "+"), looking for B6 or M5 encoding and if found it will resolve it and restore the variables in global $_GET
1622 * If values for ->cHash, ->no_cache, ->jumpurl and ->MP is found, they are also loaded into the internal vars of this class.
1624 * @param string String to analyze
1627 * @deprecated since TYPO3 4.3, will be removed in TYPO3 4.5, please use the "simulatestatic" sysext directly
1629 function idPartsAnalyze($str) {
1631 switch(substr($str,0,2)) {
1633 $addParams = base64_decode(str_replace('_','=',str_replace('-','/',substr($str,2))));
1634 parse_str($addParams,$GET_VARS);
1637 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('params', 'cache_md5params', 'md5hash='.$GLOBALS['TYPO3_DB']->fullQuoteStr(substr($str,2), 'cache_md5params'));
1638 $row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res);
1640 $this->updateMD5paramsRecord(substr($str,2));
1641 parse_str($row['params'],$GET_VARS);
1645 $this->mergingWithGetVars($GET_VARS);
1649 * Merging values into the global $_GET
1651 * @param array Array of key/value pairs that will be merged into the current GET-vars. (Non-escaped values)
1654 function mergingWithGetVars($GET_VARS) {
1655 if (is_array($GET_VARS)) {
1656 $realGet = t3lib_div
::_GET(); // Getting $_GET var, unescaped.
1657 if (!is_array($realGet)) $realGet = array();
1659 // Merge new values on top:
1660 $realGet = t3lib_div
::array_merge_recursive_overrule($realGet,$GET_VARS);
1662 // Write values back to $_GET:
1663 t3lib_div
::_GETset($realGet);
1665 // Setting these specifically (like in the init-function):
1666 if (isset($GET_VARS['type'])) $this->type
= intval($GET_VARS['type']);
1667 if (isset($GET_VARS['cHash'])) $this->cHash
= $GET_VARS['cHash'];
1668 if (isset($GET_VARS['jumpurl'])) $this->jumpurl
= $GET_VARS['jumpurl'];
1669 if (isset($GET_VARS['MP'])) $this->MP
= $this->TYPO3_CONF_VARS
['FE']['enable_mount_pids'] ?
$GET_VARS['MP'] : '';
1671 if (isset($GET_VARS['no_cache']) && $GET_VARS['no_cache']) $this->set_no_cache();
1676 * Looking for a ADMCMD_prev code, looks it up if found and returns configuration data.
1677 * Background: From the backend a request to the frontend to show a page, possibly with workspace preview can be "recorded" and associated with a keyword. When the frontend is requested with this keyword the associated request parameters are restored from the database AND the backend user is loaded - only for that request.
1678 * The main point is that a special URL valid for a limited time, eg. http://localhost/typo3site/index.php?ADMCMD_prev=035d9bf938bd23cb657735f68a8cedbf will open up for a preview that doesn't require login. Thus it's useful for sending in an email to someone without backend account.
1679 * This can also be used to generate previews of hidden pages, start/endtimes, usergroups and those other settings from the Admin Panel - just not implemented yet.
1681 * @return array Preview configuration array from sys_preview record.
1682 * @see t3lib_BEfunc::compilePreviewKeyword()
1684 function ADMCMD_preview(){
1685 $inputCode = t3lib_div
::_GP('ADMCMD_prev');
1687 // If no inputcode and a cookie is set, load input code from cookie:
1688 if (!$inputCode && $_COOKIE['ADMCMD_prev']) {
1689 $inputCode = $_COOKIE['ADMCMD_prev'];
1692 // If inputcode now, look up the settings:
1695 if ($inputCode=='LOGOUT') { // "log out":
1696 SetCookie('ADMCMD_prev', '', 0, t3lib_div
::getIndpEnv('TYPO3_SITE_PATH'));
1697 if ($this->TYPO3_CONF_VARS
['FE']['workspacePreviewLogoutTemplate']) {
1698 if (@is_file
(PATH_site
.$this->TYPO3_CONF_VARS
['FE']['workspacePreviewLogoutTemplate'])) {
1699 $message = t3lib_div
::getUrl(PATH_site
.$this->TYPO3_CONF_VARS
['FE']['workspacePreviewLogoutTemplate']);
1701 $message = '<b>ERROR!</b><br>Template File "'.$this->TYPO3_CONF_VARS
['FE']['workspacePreviewLogoutTemplate'].'" configured with $TYPO3_CONF_VARS["FE"]["workspacePreviewLogoutTemplate"] not found. Please contact webmaster about this problem.';
1704 $message = 'You logged out from Workspace preview mode. Click this link to <a href="%1$s">go back to the website</a>';
1706 die(sprintf($message,
1707 htmlspecialchars(ereg_replace('\&?ADMCMD_prev=[[:alnum:]]+','',t3lib_div
::_GET('returnUrl')))
1711 // Look for keyword configuration record:
1712 list($previewData) = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows(
1715 'keyword='.$GLOBALS['TYPO3_DB']->fullQuoteStr($inputCode, 'sys_preview').
1716 ' AND endtime>'.time()
1719 // Get: Backend login status, Frontend login status
1720 // - Make sure to remove fe/be cookies (temporarily); BE already done in ADMCMD_preview_postInit()
1721 if (is_array($previewData)) {
1722 if (!count(t3lib_div
::_POST())) {
1723 // Unserialize configuration:
1724 $previewConfig = unserialize($previewData['config']);
1726 if ($previewConfig['fullWorkspace']) { // For full workspace preview we only ADD a get variable to set the preview of the workspace - so all other Get vars are accepted. Hope this is not a security problem. Still posting is not allowed and even if a backend user get initialized it shouldn't lead to situations where users can use those credentials.
1728 // Set the workspace preview value:
1729 t3lib_div
::_GETset($previewConfig['fullWorkspace'],'ADMCMD_previewWS');
1731 // If ADMCMD_prev is set the $inputCode value cannot come from a cookie and we set that cookie here. Next time it will be found from the cookie if ADMCMD_prev is not set again...
1732 if (t3lib_div
::_GP('ADMCMD_prev')) {
1733 SetCookie('ADMCMD_prev', t3lib_div
::_GP('ADMCMD_prev'), 0, t3lib_div
::getIndpEnv('TYPO3_SITE_PATH')); // Lifetime is 1 hour, does it matter much? Requires the user to click the link from their email again if it expires.
1735 return $previewConfig;
1736 } elseif (t3lib_div
::getIndpEnv('TYPO3_SITE_URL').'index.php?ADMCMD_prev='.$inputCode === t3lib_div
::getIndpEnv('TYPO3_REQUEST_URL')) {
1738 // Set GET variables:
1740 parse_str($previewConfig['getVars'], $GET_VARS);
1741 t3lib_div
::_GETset($GET_VARS);
1743 // Return preview keyword configuration:
1744 return $previewConfig;
1745 } else die(htmlspecialchars('Request URL did not match "'.t3lib_div
::getIndpEnv('TYPO3_SITE_URL').'index.php?ADMCMD_prev='.$inputCode.'"')); // This check is to prevent people from setting additional GET vars via realurl or other URL path based ways of passing parameters.
1746 } else die('POST requests are incompatible with keyword preview.');
1747 } else die('ADMCMD command could not be executed! (No keyword configuration found)');
1752 * Configuration after initialization of TSFE object.
1753 * Basically this unsets the BE cookie if any and forces the BE user set according to the preview configuration.
1755 * @param array Preview configuration, see ADMCMD_preview()
1757 * @see ADMCMD_preview(), index_ts.php
1759 function ADMCMD_preview_postInit($previewConfig){
1760 if (is_array($previewConfig)) {
1763 unset($_COOKIE['be_typo_user']);
1764 $this->ADMCMD_preview_BEUSER_uid
= $previewConfig['BEUSER_uid'];
1766 } else die('Error in preview configuration.');
1779 /********************************************
1781 * Template and caching related functions.
1783 *******************************************/
1786 * Calculates a hash string based on additional parameters in the url. This is used to cache pages with more parameters than just id and type
1791 function makeCacheHash() {
1792 $GET = t3lib_div
::_GET();
1793 if ($this->cHash
&& is_array($GET)) {
1794 $this->cHash_array
= t3lib_div
::cHashParams(t3lib_div
::implodeArrayForUrl('',$GET));
1795 $cHash_calc = t3lib_div
::shortMD5(serialize($this->cHash_array
));
1797 if ($cHash_calc!=$this->cHash
) {
1798 if ($this->TYPO3_CONF_VARS
['FE']['pageNotFoundOnCHashError']) {
1799 $this->pageNotFoundAndExit('Request parameters could not be validated (&cHash comparison failed)');
1801 $this->set_no_cache();
1802 $GLOBALS['TT']->setTSlogMessage('The incoming cHash "'.$this->cHash
.'" and calculated cHash "'.$cHash_calc.'" did not match, so caching was disabled. The fieldlist used was "'.implode(',',array_keys($this->cHash_array
)).'"',2);
1809 * Will disable caching if the cHash value was not set.
1810 * This function should be called to check the _existence_ of "&cHash" whenever a plugin generating cachable output is using extra GET variables. If there _is_ a cHash value the validation of it automatically takes place in makeCacheHash() (see above)
1813 * @see makeCacheHash(), tslib_pibase::pi_cHashCheck()
1815 function reqCHash() {
1816 if (!$this->cHash
) {
1817 if ($this->TYPO3_CONF_VARS
['FE']['pageNotFoundOnCHashError']) {
1818 if ($this->tempContent
) { $this->clearPageCacheContent(); }
1819 $this->pageNotFoundAndExit('Request parameters could not be validated (&cHash empty)');
1821 $this->set_no_cache();
1822 $GLOBALS['TT']->setTSlogMessage('TSFE->reqCHash(): No &cHash parameter was sent for GET vars though required so caching is disabled',2);
1828 * Splits the input query-parameters into an array with certain parameters filtered out.
1829 * Used to create the cHash value
1831 * @param string Query-parameters: "&xxx=yyy&zzz=uuu"
1832 * @return array Array with key/value pairs of query-parameters WITHOUT a certain list of variable names (like id, type, no_cache etc) and WITH a variable, encryptionKey, specific for this server/installation
1834 * @see makeCacheHash(), tslib_cObj::typoLink()
1837 function cHashParams($addQueryParams) {
1838 return t3lib_div
::cHashParams($addQueryParams);
1842 * Initialize the TypoScript template parser
1846 function initTemplate() {
1847 $this->tmpl
= t3lib_div
::makeInstance('t3lib_TStemplate');
1848 $this->tmpl
->init();
1849 $this->tmpl
->tt_track
= $this->beUserLogin ?
1 : 0;
1853 * See if page is in cache and get it if so
1854 * Stores the page content in $this->content if something is found.
1858 function getFromCache() {
1859 if (!$this->no_cache
) {
1860 $cc = $this->tmpl
->getCurrentPageData();
1862 if (!is_array($cc)) {
1863 $key = $this->id
.'::'.$this->MP
;
1864 $isLocked = $this->acquirePageGenerationLock($this->pagesection_lockObj
, $key); // Returns true if the lock is active now
1867 // Lock is no longer active, the data in "cache_pagesection" is now ready
1868 $cc = $this->tmpl
->getCurrentPageData();
1869 if (is_array($cc)) {
1870 $this->releasePageGenerationLock($this->pagesection_lockObj
); // Release the lock
1875 if (is_array($cc)) {
1876 // BE CAREFUL to change the content of the cc-array. This array is serialized and an md5-hash based on this is used for caching the page.
1877 // If this hash is not the same in here in this section and after page-generation, then the page will not be properly cached!
1878 $cc = $this->tmpl
->matching($cc); // This array is an identification of the template. If $this->all is empty it's because the template-data is not cached, which it must be.
1886 $this->content
= ''; // clearing the content-variable, which will hold the pagecontent
1887 unset($this->config
); // Unsetting the lowlevel config
1888 $this->cacheContentFlag
= 0;
1890 // Look for page in cache only if caching is not disabled and if a shift-reload is not sent to the server.
1891 if (!$this->no_cache
&& !$this->headerNoCache()) {
1892 $lockHash = $this->getLockHash();
1895 $this->newHash
= $this->getHash();
1897 $GLOBALS['TT']->push('Cache Row','');
1898 $row = $this->getFromCache_queryRow();
1900 if (!is_array($row)) {
1901 $isLocked = $this->acquirePageGenerationLock($this->pages_lockObj
, $lockHash);
1904 // Lock is no longer active, the data in "cache_pages" is now ready
1905 $row = $this->getFromCache_queryRow();
1906 if (is_array($row)) {
1907 $this->releasePageGenerationLock($this->pages_lockObj
); // Release the lock
1912 if (is_array($row)) {
1913 // Release this lock
1914 $this->releasePageGenerationLock($this->pages_lockObj
);
1916 $this->config
= (array)unserialize($row['cache_data']); // Fetches the lowlevel config stored with the cached data
1917 $this->content
= $row['HTML']; // Getting the content
1918 $this->tempContent
= $row['temp_content']; // Flag for temp content
1919 $this->cacheContentFlag
= 1; // Setting flag, so we know, that some cached content has been loaded
1920 $this->cacheExpires
= $row['expires'];
1922 if ($this->TYPO3_CONF_VARS
['FE']['debug'] ||
(isset($this->config
['config']['debug']) && $this->config
['config']['debug'])) {
1923 $dateFormat = $GLOBALS['TYPO3_CONF_VARS']['SYS']['ddmmyy'];
1924 $timeFormat = $GLOBALS['TYPO3_CONF_VARS']['SYS']['hhmm'];
1926 $this->content
.= chr(10).'<!-- Cached page generated '.date($dateFormat.' '.$timeFormat, $row['tstamp']).'. Expires '.Date($dateFormat.' '.$timeFormat, $row['expires']).' -->';
1929 $GLOBALS['TT']->pull();
1932 $this->acquirePageGenerationLock($this->pages_lockObj
, $lockHash);
1938 * Returning the cached version of page with hash = newHash
1940 * @return array Cached row, if any. Otherwise void.
1942 function getFromCache_queryRow() {
1943 $GLOBALS['TT']->push('Cache Query', '');
1944 $cachedPage = $this->pageCache
->get($this->newHash
);
1945 $GLOBALS['TT']->pull();
1951 * Detecting if shift-reload has been clicked
1952 * Will not be called if re-generation of page happens by other reasons (for instance that the page is not in cache yet!)
1953 * Also, a backend user MUST be logged in for the shift-reload to be detected due to DoS-attack-security reasons.
1955 * @return boolean If shift-reload in client browser has been clicked, disable getting cached page (and regenerate it).
1957 function headerNoCache() {
1958 $disableAcquireCacheData = FALSE;
1960 if ($this->beUserLogin
) {
1961 if (strtolower($_SERVER['HTTP_CACHE_CONTROL'])==='no-cache' ||
strtolower($_SERVER['HTTP_PRAGMA'])==='no-cache') {
1962 $disableAcquireCacheData = TRUE;
1966 // Call hook for possible by-pass of requiring of page cache (for recaching purpose)
1967 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['headerNoCache'])) {
1968 $_params = array('pObj' => &$this, 'disableAcquireCacheData' => &$disableAcquireCacheData);
1969 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['headerNoCache'] as $_funcRef) {
1970 t3lib_div
::callUserFunction($_funcRef,$_params,$this);
1974 return $disableAcquireCacheData;
1978 * Calculates the cache-hash
1979 * This hash is unique to the template, the variables ->id, ->type, ->gr_list (list of groups), ->MP (Mount Points) and cHash array
1980 * Used to get and later store the cached data.
1982 * @return string MD5 hash of $this->hash_base which is a serialized version of there variables.
1984 * @see getFromCache(), getLockHash()
1986 function getHash() {
1987 $this->hash_base
= serialize(
1989 'all' => $this->all
,
1990 'id' => intval($this->id
),
1991 'type' => intval($this->type
),
1992 'gr_list' => (string)$this->gr_list
,
1993 'MP' => (string)$this->MP
,
1994 'cHash' => $this->cHash_array
1998 return md5($this->hash_base
);
2002 * Calculates the lock-hash
2003 * This hash is unique to the above hash, except that it doesn't contain the template information in $this->all.
2005 * @return string MD5 hash
2007 * @see getFromCache(), getHash()
2009 function getLockHash() {
2010 $lockHash = serialize(
2012 'id' => intval($this->id
),
2013 'type' => intval($this->type
),
2014 'gr_list' => (string)$this->gr_list
,
2015 'MP' => (string)$this->MP
,
2016 'cHash' => $this->cHash_array
2020 return md5($lockHash);
2024 * Checks if config-array exists already but if not, gets it
2028 function getConfigArray() {
2029 $setStatPageName = false;
2031 if (!is_array($this->config
) ||
is_array($this->config
['INTincScript']) ||
$this->forceTemplateParsing
) { // If config is not set by the cache (which would be a major mistake somewhere) OR if INTincScripts-include-scripts have been registered, then we must parse the template in order to get it
2032 $GLOBALS['TT']->push('Parse template','');
2034 // Force parsing, if set?:
2035 $this->tmpl
->forceTemplateParsing
= $this->forceTemplateParsing
;
2037 // Start parsing the TS template. Might return cached version.
2038 $this->tmpl
->start($this->rootLine
);
2039 $GLOBALS['TT']->pull();
2041 if ($this->tmpl
->loaded
) {
2042 $GLOBALS['TT']->push('Setting the config-array','');
2043 // t3lib_div::print_array($this->tmpl->setup);
2044 $this->sPre
= $this->tmpl
->setup
['types.'][$this->type
]; // toplevel - objArrayName
2045 $this->pSetup
= $this->tmpl
->setup
[$this->sPre
.'.'];
2047 if (!is_array($this->pSetup
)) {
2048 if ($this->checkPageUnavailableHandler()) {
2049 $this->pageUnavailableAndExit('The page is not configured! [type= '.$this->type
.']['.$this->sPre
.']');
2051 $message = 'The page is not configured! [type= '.$this->type
.']['.$this->sPre
.']';
2052 header('HTTP/1.0 503 Service Temporarily Unavailable');
2053 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
2054 $this->printError($message);
2058 $this->config
['config'] = array();
2060 // Filling the config-array, first with the main "config." part
2061 if (is_array($this->tmpl
->setup
['config.'])) {
2062 $this->config
['config'] = $this->tmpl
->setup
['config.'];
2064 // override it with the page/type-specific "config."
2065 if (is_array($this->pSetup
['config.'])) {
2066 $this->config
['config'] = t3lib_div
::array_merge_recursive_overrule($this->config
['config'], $this->pSetup
['config.']);
2069 if ($this->config
['config']['typolinkEnableLinksAcrossDomains']) {
2070 $this->config
['config']['typolinkCheckRootline'] = true;
2073 // Set default values for removeDefaultJS, inlineStyle2TempFile and minifyJS so CSS and JS are externalized/minified if compatversion is higher than 4.0
2074 if (t3lib_div
::compat_version('4.0')) {
2075 if (!isset($this->config
['config']['removeDefaultJS'])) {
2076 $this->config
['config']['removeDefaultJS'] = 'external';
2078 if (!isset($this->config
['config']['inlineStyle2TempFile'])) {
2079 $this->config
['config']['inlineStyle2TempFile'] = 1;
2081 if (!isset($this->config
['config']['minifyJS'])) {
2082 $this->config
['config']['minifyJS'] = 1;
2086 // Processing for the config_array:
2087 $this->config
['rootLine'] = $this->tmpl
->rootLine
;
2088 $this->config
['mainScript'] = trim($this->config
['config']['mainScript']) ?
trim($this->config
['config']['mainScript']) : 'index.php';
2090 // Initialize statistics handling: Check filename and permissions
2091 $setStatPageName = $this->statistics_init();
2093 $this->config
['FEData'] = $this->tmpl
->setup
['FEData'];
2094 $this->config
['FEData.'] = $this->tmpl
->setup
['FEData.'];
2096 $GLOBALS['TT']->pull();
2098 if ($this->checkPageUnavailableHandler()) {
2099 $this->pageUnavailableAndExit('No TypoScript template found!');
2101 $message = 'No TypoScript template found!';
2102 header('HTTP/1.0 503 Service Temporarily Unavailable');
2103 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
2104 $this->printError($message);
2110 // Initialize charset settings etc.
2111 $this->initLLvars();
2113 // We want nice names, so we need to handle the charset
2114 if ($setStatPageName) {
2115 $this->statistics_init_pagename();
2119 if ($this->config
['config']['no_cache']) { $this->set_no_cache(); } // Set $this->no_cache true if the config.no_cache value is set!
2122 // Hook for postProcessing the configuration array
2123 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['configArrayPostProc'])) {
2124 $params = array('config' => &$this->config
['config']);
2125 foreach ($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['configArrayPostProc'] as $funcRef) {
2126 t3lib_div
::callUserFunction($funcRef, $params, $this);
2144 /********************************************
2146 * Further initialization and data processing
2147 * (jumpurl/submission of forms)
2149 *******************************************/
2152 * Get the compressed $TCA array for use in the front-end
2153 * A compressed $TCA array holds only the ctrl- and feInterface-part for each table. But the column-definitions are omitted in order to save some memory and be more efficient.
2154 * Operates on the global variable, $TCA
2159 function getCompressedTCarray() {
2162 $GLOBALS['TT']->push('Get Compressed TC array');
2163 if (!$this->TCAloaded
) {
2164 // Create hash string for storage / retrieval of cached content:
2165 $tempHash = md5('tables.php:'.
2166 filemtime(TYPO3_extTableDef_script ? PATH_typo3conf
.TYPO3_extTableDef_script
: PATH_t3lib
.'stddb/tables.php').
2167 (TYPO3_extTableDef_script?
filemtime(PATH_typo3conf
.TYPO3_extTableDef_script
):'').
2168 ($GLOBALS['TYPO3_LOADED_EXT']['_CACHEFILE'] ?
filemtime(PATH_typo3conf
.$GLOBALS['TYPO3_LOADED_EXT']['_CACHEFILE'].'_ext_tables.php') : '')
2171 if ($this->TYPO3_CONF_VARS
['EXT']['extCache'] != 0) {
2172 // Try to fetch if cache is enabled
2173 list($TCA, $this->TCAcachedExtras
) = unserialize($this->sys_page
->getHash($tempHash));
2176 // If no result, create it:
2177 if (!is_array($TCA)) {
2178 $this->includeTCA(0);
2180 $this->TCAcachedExtras
= array(); // Collects other information
2182 foreach($TCA as $key => $val) {
2183 $newTc[$key]['ctrl'] = $val['ctrl'];
2184 $newTc[$key]['feInterface'] = $val['feInterface'];
2186 // Collect information about localization exclusion of fields:
2187 t3lib_div
::loadTCA($key);
2188 if (is_array($TCA[$key]['columns'])) {
2189 $this->TCAcachedExtras
[$key]['l10n_mode'] = array();
2190 foreach($TCA[$key]['columns'] as $fN => $fV) {
2191 if ($fV['l10n_mode']) {
2192 $this->TCAcachedExtras
[$key]['l10n_mode'][$fN] = $fV['l10n_mode'];
2199 // Store it in cache if cache is enabled
2200 if ($this->TYPO3_CONF_VARS
['EXT']['extCache'] != 0) {
2201 $this->sys_page
->storeHash($tempHash, serialize(array($newTc,$this->TCAcachedExtras
)), 'SHORT_TC');
2205 $GLOBALS['TT']->pull();
2209 * Includes TCA definitions from loaded extensions (ext_table.php files).
2210 * Normally in the frontend only a part of the global $TCA array is loaded,
2211 * namely the "ctrl" part. Thus it doesn't take up too much memory. To load
2212 * full TCA for the table, use t3lib_div::loadTCA($tableName) after calling
2215 * @param boolean Probably, keep hands of this value. Just don't set it. (This may affect the first-ever time this function is called since if you set it to zero/false any subsequent call will still trigger the inclusion; In other words, this value will be set in $this->TCAloaded after inclusion and therefore if its false, another inclusion will be possible on the next call. See ->getCompressedTCarray())
2217 * @see getCompressedTCarray()
2219 function includeTCA($TCAloaded=1) {
2220 global $TCA, $PAGES_TYPES, $LANG_GENERAL_LABELS, $TBE_MODULES;
2221 if (!$this->TCAloaded
) {
2223 include (TYPO3_tables_script ? PATH_typo3conf
.TYPO3_tables_script
: PATH_t3lib
.'stddb/tables.php');
2224 // Extension additions
2225 if ($GLOBALS['TYPO3_LOADED_EXT']['_CACHEFILE']) {
2226 include(PATH_typo3conf
.$GLOBALS['TYPO3_LOADED_EXT']['_CACHEFILE'].'_ext_tables.php');
2228 include(PATH_t3lib
.'stddb/load_ext_tables.php');
2231 if (TYPO3_extTableDef_script
) {
2232 include (PATH_typo3conf
.TYPO3_extTableDef_script
);
2235 $this->TCAloaded
= $TCAloaded;
2240 * Setting the language key that will be used by the current page.
2241 * In this function it should be checked, 1) that this language exists, 2) that a page_overlay_record exists, .. and if not the default language, 0 (zero), should be set.
2246 function settingLanguage() {
2248 // Get values from TypoScript:
2249 $this->sys_language_uid
= $this->sys_language_content
= intval($this->config
['config']['sys_language_uid']);
2250 list($this->sys_language_mode
,$sys_language_content) = t3lib_div
::trimExplode(';', $this->config
['config']['sys_language_mode']);
2251 $this->sys_language_contentOL
= $this->config
['config']['sys_language_overlay'];
2253 // If sys_language_uid is set to another language than default:
2254 if ($this->sys_language_uid
>0) {
2256 // check whether a shortcut is overwritten by a translated page
2257 // we can only do this now, as this is the place where we get
2258 // to know about translations
2259 $this->checkTranslatedShortcut();
2261 // Request the overlay record for the sys_language_uid:
2262 $olRec = $this->sys_page
->getPageOverlay($this->id
, $this->sys_language_uid
);
2263 if (!count($olRec)) {
2265 // If no OL record exists and a foreign language is asked for...
2266 if ($this->sys_language_uid
) {
2268 // If requested translation is not available:
2269 if (t3lib_div
::hideIfNotTranslated($this->page
['l18n_cfg'])) {
2270 $this->pageNotFoundAndExit('Page is not available in the requested language.');
2272 switch((string)$this->sys_language_mode
) {
2274 $this->pageNotFoundAndExit('Page is not available in the requested language (strict).');
2276 case 'content_fallback':
2277 $fallBackOrder = t3lib_div
::intExplode(',', $sys_language_content);
2278 foreach($fallBackOrder as $orderValue) {
2279 if (!strcmp($orderValue,'0') ||
count($this->sys_page
->getPageOverlay($this->id
, $orderValue))) {
2280 $this->sys_language_content
= $orderValue; // Setting content uid (but leaving the sys_language_uid)
2286 $this->sys_language_content
= $this->sys_language_uid
;
2289 // Default is that everything defaults to the default language...
2290 $this->sys_language_uid
= $this->sys_language_content
= 0;
2296 // Setting sys_language if an overlay record was found (which it is only if a language is used)
2297 $this->page
= $this->sys_page
->getPageOverlay($this->page
, $this->sys_language_uid
);
2301 // Setting sys_language_uid inside sys-page:
2302 $this->sys_page
->sys_language_uid
= $this->sys_language_uid
;
2304 // If default translation is not available:
2305 if ((!$this->sys_language_uid ||
!$this->sys_language_content
) && $this->page
['l18n_cfg']&1) {
2306 $message = 'Page is not available in default language.';
2307 t3lib_div
::sysLog($message, 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
2308 $this->pageNotFoundAndExit($message);
2311 // Updating content of the two rootLines IF the language key is set!
2312 if ($this->sys_language_uid
&& is_array($this->tmpl
->rootLine
)) {
2313 reset($this->tmpl
->rootLine
);
2314 while(list($rLk)=each($this->tmpl
->rootLine
)) {
2315 $this->tmpl
->rootLine
[$rLk] = $this->sys_page
->getPageOverlay($this->tmpl
->rootLine
[$rLk]);
2318 if ($this->sys_language_uid
&& is_array($this->rootLine
)) {
2319 reset($this->rootLine
);
2320 while(list($rLk)=each($this->rootLine
)) {
2321 $this->rootLine
[$rLk] = $this->sys_page
->getPageOverlay($this->rootLine
[$rLk]);
2325 // Finding the ISO code:
2326 if (t3lib_extMgm
::isLoaded('static_info_tables') && $this->sys_language_content
) { // using sys_language_content because the ISO code only (currently) affect content selection from FlexForms - which should follow "sys_language_content"
2327 $sys_language_row = $this->sys_page
->getRawRecord('sys_language',$this->sys_language_content
,'static_lang_isocode');
2328 if (is_array($sys_language_row) && $sys_language_row['static_lang_isocode']) {
2329 $stLrow = $this->sys_page
->getRawRecord('static_languages',$sys_language_row['static_lang_isocode'],'lg_iso_2');
2330 $this->sys_language_isocode
= $stLrow['lg_iso_2'];
2334 // Setting softMergeIfNotBlank:
2335 $table_fields = t3lib_div
::trimExplode(',', $this->config
['config']['sys_language_softMergeIfNotBlank'],1);
2336 foreach($table_fields as $TF) {
2337 list($tN,$fN) = explode(':',$TF);
2338 $this->TCAcachedExtras
[$tN]['l10n_mode'][$fN] = 'mergeIfNotBlank';
2341 // Setting softExclude:
2342 $table_fields = t3lib_div
::trimExplode(',', $this->config
['config']['sys_language_softExclude'],1);
2343 foreach($table_fields as $TF) {
2344 list($tN,$fN) = explode(':',$TF);
2345 $this->TCAcachedExtras
[$tN]['l10n_mode'][$fN] = 'exclude';
2350 * Setting locale for frontend rendering
2354 function settingLocale() {
2357 if ($this->config
['config']['locale_all']) {
2358 # Change by Rene Fritz, 22/10 2002
2359 # there's a problem that PHP parses float values in scripts wrong if the locale LC_NUMERIC is set to something with a comma as decimal point
2360 # this does not work in php 4.2.3
2361 #setlocale('LC_ALL',$this->config['config']['locale_all']);
2362 #setlocale('LC_NUMERIC','en_US');
2364 # so we set all except LC_NUMERIC
2365 $locale = setlocale(LC_COLLATE
, $this->config
['config']['locale_all']);
2367 setlocale(LC_CTYPE
, $this->config
['config']['locale_all']);
2368 setlocale(LC_MONETARY
, $this->config
['config']['locale_all']);
2369 setlocale(LC_TIME
, $this->config
['config']['locale_all']);
2371 $this->localeCharset
= $this->csConvObj
->get_locale_charset($this->config
['config']['locale_all']);
2373 $GLOBALS['TT']->setTSlogMessage('Locale "'.htmlspecialchars($this->config
['config']['locale_all']).'" not found.', 3);
2379 * checks whether a translated shortcut page has a different shortcut
2380 * target than the original language page.
2381 * If that is the case, things get corrected to follow that alternative
2385 * @author Ingo Renner <ingo@typo3.org>
2387 protected function checkTranslatedShortcut() {
2389 if (!is_null($this->originalShortcutPage
)) {
2390 $originalShortcutPageOverlay = $this->sys_page
->getPageOverlay($this->originalShortcutPage
['uid'], $this->sys_language_uid
);
2392 if (!empty($originalShortcutPageOverlay['shortcut']) && $originalShortcutPageOverlay['shortcut'] != $this->id
) {
2393 // the translation of the original shortcut page has a different shortcut target!
2394 // set the correct page and id
2396 $shortcut = $this->getPageShortcut(
2397 $originalShortcutPageOverlay['shortcut'],
2398 $originalShortcutPageOverlay['shortcut_mode'],
2399 $originalShortcutPageOverlay['uid']
2402 $this->id
= $this->contentPid
= $shortcut['uid'];
2403 $this->page
= $this->sys_page
->getPage($this->id
);
2405 // fix various effects on things like menus f.e.
2406 $this->fetch_the_id();
2407 $this->tmpl
->rootLine
= array_reverse($this->rootLine
);
2413 * Checks if any email-submissions or submission via the fe_tce
2415 * @return string "email" if a formmail has been sent, "fe_tce" if front-end data submission (like forums, guestbooks) is sent. "" if none.
2417 function checkDataSubmission() {
2419 $formtype_db = isset($_POST['formtype_db']) ||
isset($_POST['formtype_db_x']);
2420 $formtype_mail = isset($_POST['formtype_mail']) ||
isset($_POST['formtype_mail_x']);
2421 if ($formtype_db ||
$formtype_mail) {
2422 $refInfo = parse_url(t3lib_div
::getIndpEnv('HTTP_REFERER'));
2423 if (t3lib_div
::getIndpEnv('TYPO3_HOST_ONLY')==$refInfo['host'] ||
$this->TYPO3_CONF_VARS
['SYS']['doNotCheckReferer']) {
2424 if ($this->locDataCheck($_POST['locationData'])) {
2425 if ($formtype_mail) {
2427 } elseif ($formtype_db && is_array($_POST['data'])) {
2430 $GLOBALS['TT']->setTSlogMessage('"Check Data Submission": Return value: '.$ret,0);
2433 } else $GLOBALS['TT']->setTSlogMessage('"Check Data Submission": HTTP_HOST and REFERER HOST did not match when processing submitted formdata!',3);
2436 // Hook for processing data submission to extensions:
2437 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkDataSubmission'])) {
2438 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkDataSubmission'] as $_classRef) {
2439 $_procObj = &t3lib_div
::getUserObj($_classRef);
2440 $_procObj->checkDataSubmission($this);
2447 * Processes submitted user data (obsolete "Frontend TCE")
2451 * @link http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=270&tx_extrepmgm_pi1[tocEl]=342&cHash=fdf55adb3b
2454 $fe_tce = t3lib_div
::makeInstance('tslib_feTCE');
2455 $fe_tce->start(t3lib_div
::_POST('data'),$this->config
['FEData.']);
2456 $fe_tce->includeScripts();
2460 * Checks if a formmail submission can be sent as email
2462 * @param string The input from $_POST['locationData']
2465 * @see checkDataSubmission()
2467 function locDataCheck($locationData) {
2468 $locData = explode(':',$locationData);
2469 if (!$locData[1] ||
$this->sys_page
->checkRecord($locData[1],$locData[2],1)) {
2470 if (count($this->sys_page
->getPage($locData[0]))) { // $locData[1] -check means that a record is checked only if the locationData has a value for a record else than the page.
2472 } else $GLOBALS['TT']->setTSlogMessage('LocationData Error: The page pointed to by location data ('.$locationData.') was not accessible.',2);
2473 } else $GLOBALS['TT']->setTSlogMessage('LocationData Error: Location data ('.$locationData.') record pointed to was not accessible.',2);
2477 * Sends the emails from the formmail content object.
2481 * @see checkDataSubmission()
2483 function sendFormmail() {
2484 $formmail = t3lib_div
::makeInstance('t3lib_formmail');
2486 $EMAIL_VARS = t3lib_div
::_POST();
2487 $locationData = $EMAIL_VARS['locationData'];
2488 unset($EMAIL_VARS['locationData']);
2489 unset($EMAIL_VARS['formtype_mail'], $EMAIL_VARS['formtype_mail_x'], $EMAIL_VARS['formtype_mail_y']);
2491 $integrityCheck = $this->TYPO3_CONF_VARS
['FE']['strictFormmail'];
2493 if (!$this->TYPO3_CONF_VARS
['FE']['secureFormmail']) {
2494 // Check recipient field:
2495 $encodedFields = explode(',','recipient,recipient_copy'); // These two fields are the ones which contain recipient addresses that can be misused to send mail from foreign servers.
2496 foreach ($encodedFields as $fieldKey) {
2497 if (strlen($EMAIL_VARS[$fieldKey])) {
2498 if ($res = $this->codeString($EMAIL_VARS[$fieldKey], TRUE)) { // Decode...
2499 $EMAIL_VARS[$fieldKey] = $res; // Set value if OK
2500 } elseif ($integrityCheck) { // Otherwise abort:
2501 $GLOBALS['TT']->setTSlogMessage('"Formmail" discovered a field ('.$fieldKey.') which could not be decoded to a valid string. Sending formmail aborted due to security reasons!',3);
2504 $GLOBALS['TT']->setTSlogMessage('"Formmail" discovered a field ('.$fieldKey.') which could not be decoded to a valid string. The security level accepts this, but you should consider a correct coding though!',2);
2509 $locData = explode(':',$locationData);
2510 $record = $this->sys_page
->checkRecord($locData[1],$locData[2],1);
2511 $EMAIL_VARS['recipient'] = $record['subheader'];
2512 $EMAIL_VARS['recipient_copy'] = $this->extractRecipientCopy($record['bodytext']);
2515 // Hook for preprocessing of the content for formmails:
2516 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['sendFormmail-PreProcClass'])) {
2517 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['sendFormmail-PreProcClass'] as $_classRef) {
2518 $_procObj = &t3lib_div
::getUserObj($_classRef);
2519 $EMAIL_VARS = $_procObj->sendFormmail_preProcessVariables($EMAIL_VARS,$this);
2523 $formmail->start($EMAIL_VARS);
2524 $formmail->sendtheMail();
2525 $GLOBALS['TT']->setTSlogMessage('"Formmail" invoked, sending mail to '.$EMAIL_VARS['recipient'],0);
2529 * Extracts the value of recipient copy field from a formmail CE bodytext
2531 * @param string $bodytext The content of the related bodytext field
2532 * @return string The value of the recipient_copy field, or an empty string
2534 function extractRecipientCopy($bodytext) {
2535 $recipient_copy = '';
2537 //|recipient_copy=hidden|karsten@localhost.localdomain
2538 preg_match('/^[\s]*\|[\s]*recipient_copy[\s]*=[\s]*hidden[\s]*\|(.*)$/m', $bodytext, $fdef);
2539 $recipient_copy = (!empty($fdef[1])) ?
$fdef[1] : '';
2540 return $recipient_copy;
2544 * Sets the jumpurl for page type "External URL"
2548 function setExternalJumpUrl() {
2549 if ($extUrl = $this->sys_page
->getExtURL($this->page
, $this->config
['config']['disablePageExternalUrl'])) {
2550 $this->jumpurl
= $extUrl;
2555 * Check the jumpUrl referer if required
2559 function checkJumpUrlReferer() {
2560 if (strlen($this->jumpurl
) && !$this->TYPO3_CONF_VARS
['SYS']['doNotCheckReferer']) {
2561 $referer = parse_url(t3lib_div
::getIndpEnv('HTTP_REFERER'));
2562 if (isset($referer['host']) && !($referer['host'] == t3lib_div
::getIndpEnv('TYPO3_HOST_ONLY'))) {
2563 unset($this->jumpurl
);
2569 * Sends a header "Location" to jumpUrl, if jumpurl is set.
2570 * Will exit if a location header is sent (for instance if jumpUrl was triggered)
2572 * "jumpUrl" is a concept where external links are redirected from the index_ts.php script, which first logs the URL.
2573 * This feature is only interesting if config.sys_stat is used.
2577 function jumpUrl() {
2578 if ($this->jumpurl
) {
2579 if (t3lib_div
::_GP('juSecure')) {
2582 t3lib_div
::_GP('locationData'),
2583 $this->TYPO3_CONF_VARS
['SYS']['encryptionKey']
2585 $calcJuHash=t3lib_div
::shortMD5(serialize($hArr));
2586 $locationData = t3lib_div
::_GP('locationData');
2587 $juHash = t3lib_div
::_GP('juHash');
2588 if ($juHash == $calcJuHash) {
2589 if ($this->locDataCheck($locationData)) {
2590 $this->jumpurl
= rawurldecode($this->jumpurl
); // 211002 - goes with cObj->filelink() rawurlencode() of filenames so spaces can be allowed.
2591 if (@is_file
($this->jumpurl
)) {
2592 $mimeType = t3lib_div
::_GP('mimeType');
2593 $mimeType = $mimeType ?
$mimeType : 'application/octet-stream';
2594 header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
2595 header('Content-Type: '.$mimeType);
2596 header('Content-Disposition: attachment; filename='.basename($this->jumpurl
));
2597 readfile($this->jumpurl
);
2599 } else die('jumpurl Secure: "'.$this->jumpurl
.'" was not a valid file!');
2600 } else die('jumpurl Secure: locationData, '.$locationData.', was not accessible.');
2601 } else die('jumpurl Secure: Calculated juHash did not match the submitted juHash.');
2603 $TSConf = $this->getPagesTSconfig();
2604 if ($TSConf['TSFE.']['jumpUrl_transferSession']) {
2605 $uParts = parse_url($this->jumpurl
);
2606 $params = '&FE_SESSION_KEY='.rawurlencode($this->fe_user
->id
.'-'.md5($this->fe_user
->id
.'/'.$this->TYPO3_CONF_VARS
['SYS']['encryptionKey']));
2607 $this->jumpurl
.= ($uParts['query']?
'':'?').$params; // Add the session parameter ...
2609 if ($TSConf['TSFE.']['jumpURL_HTTPStatusCode']) {
2610 switch (intval($TSConf['TSFE.']['jumpURL_HTTPStatusCode'])){
2612 header(t3lib_div
::HTTP_STATUS_301
);
2615 header(t3lib_div
::HTTP_STATUS_302
);
2618 header(t3lib_div
::HTTP_STATUS_303
);
2621 header(t3lib_div
::HTTP_STATUS_307
);
2627 header('Location: '.$this->jumpurl
);
2634 * Sets the URL_ID_TOKEN in the internal var, $this->getMethodUrlIdToken
2635 * This feature allows sessions to use a GET-parameter instead of a cookie.
2640 function setUrlIdToken() {
2641 if ($this->config
['config']['ftu']) {
2642 $this->getMethodUrlIdToken
= $this->TYPO3_CONF_VARS
['FE']['get_url_id_token'];
2644 $this->getMethodUrlIdToken
= '';
2670 /********************************************
2672 * Page generation; cache handling
2674 *******************************************/
2677 * Returns true if the page should be generated
2678 * That is if jumpurl is not set and the cacheContentFlag is not set.
2682 function isGeneratePage() {
2683 return (!$this->cacheContentFlag
&& !$this->jumpurl
);
2687 * Temp cache content
2688 * The temporary cache will expire after a few seconds (typ. 30) or will be cleared by the rendered page, which will also clear and rewrite the cache.
2692 function tempPageCacheContent() {
2693 $this->tempContent
= false;
2695 if (!$this->no_cache
) {
2697 $title = htmlspecialchars($this->tmpl
->printTitle($this->page
['title']));
2698 $request_uri = htmlspecialchars(t3lib_div
::getIndpEnv('REQUEST_URI'));
2701 <strong>Page is being generated.</strong><br />
2702 If this message does not disappear within '.$seconds.' seconds, please reload.';
2704 $message = $this->config
['config']['message_page_is_being_generated'];
2705 if (strcmp('', $message)) {
2706 $message = $this->csConvObj
->utf8_encode($message,$this->renderCharset
); // This page is always encoded as UTF-8
2707 $message = str_replace('###TITLE###', $title, $message);
2708 $message = str_replace('###REQUEST_URI###', $request_uri, $message);
2709 } else $message = $stdMsg;
2711 $temp_content = '<?xml version="1.0" encoding="UTF-8"?>
2712 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2713 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2714 <html xmlns="http://www.w3.org/1999/xhtml">
2716 <title>'.$title.'</title>
2717 <meta http-equiv="refresh" content="10" />
2719 <body style="background-color:white; font-family:Verdana,Arial,Helvetica,sans-serif; color:#cccccc; text-align:center;">'.
2724 // Fix 'nice errors' feature in modern browsers
2725 $padSuffix = '<!--pad-->'; // prevent any trims
2726 $padSize = 768 - strlen($padSuffix) - strlen($temp_content);
2728 $temp_content = str_pad($temp_content, $padSize, "\n") . $padSuffix;
2731 if (!$this->headerNoCache() && $cachedRow = $this->getFromCache_queryRow()) {
2732 // We are here because between checking for cached content earlier and now some other HTTP-process managed to store something in cache AND it was not due to a shift-reload by-pass.
2733 // This is either the "Page is being generated" screen or it can be the final result.
2734 // In any case we should not begin another rendering process also, so we silently disable caching and render the page ourselves and thats it.
2735 // Actually $cachedRow contains content that we could show instead of rendering. Maybe we should do that to gain more performance but then we should set all the stuff done in $this->getFromCache()... For now we stick to this...
2736 $this->set_no_cache();
2738 $this->tempContent
= TRUE; // This flag shows that temporary content is put in the cache
2739 $this->setPageCacheContent($temp_content, $this->config
, $GLOBALS['EXEC_TIME']+
$seconds);
2745 * Set cache content to $this->content
2749 function realPageCacheContent() {
2750 $cache_timeout = $this->get_cache_timeout(); // seconds until a cached page is too old
2751 $timeOutTime = $GLOBALS['EXEC_TIME']+
$cache_timeout;
2752 if ($this->config
['config']['cache_clearAtMidnight']) {
2753 $midnightTime = mktime (0,0,0,date('m',$timeOutTime),date('d',$timeOutTime),date('Y',$timeOutTime));
2754 if ($midnightTime > $GLOBALS['EXEC_TIME']) { // If the midnight time of the expire-day is greater than the current time, we may set the timeOutTime to the new midnighttime.
2755 $timeOutTime = $midnightTime;
2758 $this->tempContent
= false;
2759 $this->setPageCacheContent($this->content
, $this->config
, $timeOutTime);
2761 // Hook for cache post processing (eg. writing static files!)
2762 if (is_array($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['insertPageIncache'])) {
2763 foreach($this->TYPO3_CONF_VARS
['SC_OPTIONS']['tslib/class.tslib_fe.php']['insertPageIncache'] as $_classRef) {
2764 $_procObj = &t3lib_div
::getUserObj($_classRef);
2765 $_procObj->insertPageIncache($this,$timeOutTime);
2771 * Sets cache content; Inserts the content string into the cache_pages cache.
2773 * @param string The content to store in the HTML field of the cache table
2774 * @param mixed The additional cache_data array, fx. $this->config
2775 * @param integer Expiration timestamp
2777 * @see realPageCacheContent(), tempPageCacheContent()
2779 function setPageCacheContent($content, $data, $expirationTstamp) {
2780 $this->clearPageCacheContent();
2783 'hash' => $this->newHash
,
2784 'page_id' => $this->id
,
2786 'temp_content' => $this->tempContent
,
2787 'cache_data' => serialize($data),
2788 'expires' => $expirationTstamp,
2789 'tstamp' => $GLOBALS['EXEC_TIME']
2792 $this->cacheExpires
= $expirationTstamp;
2794 $this->pageCacheTags
[] = 'pageId_' . $cacheData['page_id'];
2796 if ($this->page_cache_reg1
) {
2797 $reg1 = intval($this->page_cache_reg1
);
2799 $cacheData['reg1'] = $reg1;
2800 $this->pageCacheTags
[] = 'reg1_' . $reg1;
2803 $this->pageCache
->set(
2806 $this->pageCacheTags
,
2807 $cacheData['expires'] - $GLOBALS['EXEC_TIME']
2812 * Clears cache content (for $this->newHash)
2816 function clearPageCacheContent() {
2817 $this->pageCache
->remove($this->newHash
);
2821 * Clears cache content for a list of page ids
2823 * @param string A list of INTEGER numbers which points to page uids for which to clear entries in the cache_pages cache (page content cache)
2826 function clearPageCacheContent_pidList($pidList) {
2827 $pageIds = t3lib_div
::trimExplode(',', $pidList);
2829 foreach ($pageIds as $pageId) {
2830 $this->pageCache
->flushByTag('pageId_' . (int) $pageId);
2835 * Sets sys last changed
2836 * Setting the SYS_LASTCHANGED value in the pagerecord: This value will thus be set to the highest tstamp of records rendered on the page. This includes all records with no regard to hidden records, userprotection and so on.
2839 * @see tslib_cObj::lastChanged()
2841 function setSysLastChanged() {
2842 if ($this->page
['SYS_LASTCHANGED'] < intval($this->register
['SYS_LASTCHANGED'])) {
2843 $GLOBALS['TYPO3_DB']->exec_UPDATEquery('pages', 'uid='.intval($this->id
), array('SYS_LASTCHANGED' => intval($this->register
['SYS_LASTCHANGED'])));
2848 * Lock the page generation process
2849 * The lock is used to queue page requests until this page is successfully stored in the cache.
2851 * @param t3lib_lock Reference to a locking object
2852 * @param string String to identify the lock in the system
2853 * @return boolean Returns true if the lock could be obtained, false otherwise (= process had to wait for existing lock to be released)
2854 * @see releasePageGenerationLock()
2856 function acquirePageGenerationLock(&$lockObj, $key) {
2857 if ($this->no_cache ||
$this->headerNoCache()) {
2858 t3lib_div
::sysLog('Locking: Page is not cached, no locking required', 'cms', t3lib_div
::SYSLOG_SEVERITY_INFO
);
2859 return true; // No locking is needed if caching is disabled
2863 if (!is_object($lockObj)) {
2864 $lockObj = t3lib_div
::makeInstance('t3lib_lock', $key, $this->TYPO3_CONF_VARS
['SYS']['lockingMode']);
2869 // true = Page could get locked without blocking
2870 // false = Page could get locked but process was blocked before
2871 $success = $lockObj->acquire();
2872 if ($lockObj->getLockStatus()) {
2873 $lockObj->sysLog('Acquired lock');
2876 } catch (Exception
$e) {
2877 t3lib_div
::sysLog('Locking: Failed to acquire lock: '.$e->getMessage(), 'cms', t3lib_div
::SYSLOG_SEVERITY_ERROR
);
2878 $success = false; // If locking fails, return with false and continue without locking
2885 * Release the page generation lock
2887 * @param t3lib_lock Reference to a locking object
2888 * @return boolean Returns true on success, false otherwise
2889 * @see acquirePageGenerationLock()
2891 function releasePageGenerationLock(&$lockObj) {
2893 // If lock object is set and was acquired (may also happen if no_cache was enabled during runtime), release it:
2894 if (is_object($lockObj) && $lockObj instanceof t3lib_lock
&& $lockObj->getLockStatus()) {
2895 $success = $lockObj->release();
2896 $lockObj->sysLog('Released lock');
2898 // Otherwise, if caching is disabled, no locking is required:
2899 } elseif ($this->no_cache ||
$this->headerNoCache()) {
2906 * adds tags to this page's cache entry, you can then f.e. remove cache
2909 * @param array an array of tag
2912 public function addCacheTags(array $tags) {
2913 $this->pageCacheTags
= array_merge($this->pageCacheTags
, $tags);
2935 /********************************************
2937 * Page generation; rendering and inclusion
2939 *******************************************/
2942 * Does some processing BEFORE the pagegen script is included.
2946 function generatePage_preProcessing() {
2947 $this->newHash
= $this->getHash(); // Same codeline as in getFromCache(). But $this->all has been changed by t3lib_TStemplate::start() in the meantime, so this must be called again!
2948 $this->config
['hash_base'] = $this->hash_base
; // For cache management informational purposes.
2950 if (!is_object($this->pages_lockObj
) ||
$this->pages_lockObj
->getLockStatus()==false) {
2951 // Here we put some temporary stuff in the cache in order to let the first hit generate the page. The temporary cache will expire after a few seconds (typ. 30) or will be cleared by the rendered page, which will also clear and rewrite the cache.
2952 $this->tempPageCacheContent();
2955 // Setting cache_timeout_default. May be overridden by PHP include scritps.
2956 $this->cacheTimeOutDefault
= intval($this->config
['config']['cache_period']);
2958 // page is generated
2959 $this->no_cacheBeforePageGen
= $this->no_cache
;
2963 * Determines to include custom or pagegen.php script
2964 * returns script-filename if a TypoScript (config) script is defined and should be include instead of pagegen.php
2966 * @return string The relative filepath of "config.pageGenScript" if found and allowed