Feature #17992

Add pageUnavailable_handling for system problems and maintenance

Added by Jeff Segars over 12 years ago. Updated almost 10 years ago.

Should have
Target version:
Start date:
Due date:
% Done:


PHP Version:
Sprint Focus:


There are already several places in the TYPO3 Core where an HTTP 503 Not Available header is sent in response to major problems rendering the page. This occurs mainly when a database connection is unavailable or there's a serious problem getting the requested page and template. In each of these cases, the 503 header is sent and a specific, but static a error message is displayed.

I would propose that we add an equivalent to pageNotFound_handling for the times when a page is unavailable. This would allow a customized maintenance page to automatically be displayed when problems occur (ie. database goes down) and for the normal site to return immediately when those problems are resolved. I'd also suggest an Install Tool setting to manually turn this maintenance page off and on whenever the site admin is performing maintenance.

I'm attaching an inital version of patch for this. It adds some Install Tool settings to t3lib/config_default.php and mimics the pageNotFound_handling in tslib_fe. There's also a small addition to tslib/index_ts.php that checks if pageUnavailable has been forced after TSFE is created, but before a database connection is attempted.

The one thing this patch does not currently handle is the "Page is being generated" message since there's some additional complexity with it.

(issue imported from #M7150)

pageUnavailable.diff View (14.3 KB) Administrator Admin, 2008-01-21 03:23

pageUnavailable_v3.diff View (15.2 KB) Administrator Admin, 2008-02-29 04:53

Related issues

Duplicated by TYPO3 Core - Feature #16617: Custom error pages Closed 2006-10-04


#1 Updated by Steffen Kamper over 12 years ago

This patch works for me.
Great, i requested such a feature some time ago.

Setting this in localconf.php
$TYPO3_CONF_VARS['FE']['pageUnavailable_force'] = 1;

will show in FE:


Reason: This page is temporarily unavailable.

Thanks Jeff for this great patch!

#2 Updated by Jeff Segars over 12 years ago

Latest attached patch (pageUnavailable_v3.diff) was committed to 4.2 branch.

Also available in: Atom PDF