* @version 0.0.0
* @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2012 Core Developer Team
* @license GNU GPL 3.0 or any newer version
* @link http://www.shipsimu.org
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
final class ApplicationEntryPoint {
/**
* Core path
*/
private static $corePath = '';
/**
* The application's emergency exit
*
* @param $message The optional message we shall output on exit
* @param $code Error code from exception
* @param $extraData Extra information from exceptions
* @param $silentMode Whether silent mode is turned on
* @return void
* @todo This method is old code and needs heavy rewrite and should be moved to ApplicationHelper
*/
public static final function app_exit ($message = '', $code = FALSE, $extraData = '', $silentMode = FALSE) {
// Is this method already called?
if (isset($GLOBALS['app_die_called'])) {
// Then output the text directly
exit($message);
} // END - if
// This method shall not be called twice
$GLOBALS['app_die_called'] = TRUE;
// Is a message set?
if (empty($message)) {
// No message provided
$message = 'No message provided.';
} // END - if
// Get config instance
$configInstance = FrameworkConfiguration::getSelfInstance();
// Do we have debug installation?
if (($configInstance->getConfigEntry('product_install_mode') == 'productive') || ($silentMode === TRUE)) {
// Abort here
exit();
} // END - if
// Get some instances
$tpl = FrameworkConfiguration::getSelfInstance()->getConfigEntry('web_template_class');
$languageInstance = LanguageSystem::getSelfInstance();
// Initialize template instance here to avoid warnings in IDE
$templateInstance = NULL;
// Get response instance
$responseInstance = ApplicationHelper::getSelfInstance()->getResponseInstance();
// Is the template engine loaded?
if ((class_exists($tpl)) && (is_object($languageInstance))) {
// Use the template engine for putting out (nicer look) the message
try {
// Get the template instance from our object factory
$templateInstance = ObjectFactory::createObjectByName($tpl);
} catch (FrameworkException $e) {
exit(sprintf("[Main:] Could not initialize template engine for reason: %s",
$e->getMessage()
));
}
// Get and prepare backtrace for output
$backtraceArray = debug_backtrace();
$backtrace = '';
foreach ($backtraceArray as $key => $trace) {
// Set missing array elements
if (!isset($trace['file'])) {
$trace['file'] = __FILE__;
} // END - if
if (!isset($trace['line'])) {
$trace['line'] = __LINE__;
} // END - if
if (!isset($trace['args'])) {
$trace['args'] = array();
} // END - if
// Add the traceback path to the final output
$backtrace .= sprintf("%s:%d, %s(%d)
\n",
basename($trace['file']),
$trace['line'],
$trace['function'],
count($trace['args'])
);
} // END - foreach
// Init application instance
$applicationInstance = NULL;
// Is the class there?
if (class_exists('ApplicationHelper')) {
// Get application instance
$applicationInstance = ApplicationHelper::getSelfInstance();
// Assign application data
$templateInstance->assignApplicationData($applicationInstance);
} // END - if
// We only try this
try {
// Assign variables
$templateInstance->assignVariable('message', $message);
$templateInstance->assignVariable('code', $code);
$templateInstance->assignVariable('extra', $extraData);
$templateInstance->assignVariable('backtrace', $backtrace);
$templateInstance->assignVariable('total_includes', ClassLoader::getSelfInstance()->getTotal());
$templateInstance->assignVariable('total_objects', ObjectFactory::getTotal());
$templateInstance->assignVariable('title', $languageInstance->getMessage('emergency_exit_title'));
// Load the template
$templateInstance->loadCodeTemplate('emergency_exit');
// Compile the template
$templateInstance->compileTemplate();
// Compile all variables
$templateInstance->compileVariables();
// Transfer data to response
$templateInstance->transferToResponse($responseInstance);
// Flush the response
$responseInstance->flushBuffer();
} catch (FileIoException $e) {
// Even the template 'emergency_exit' wasn't found so output both message
exit($message . ', exception: ' . $e->getMessage());
}
// Good bye...
exit();
} else {
// Output message and die
exit(sprintf('[Main:] Emergency exit reached: %s',
$message
));
}
}
/**
* Determines the correct absolute path for all includes only once per run.
* Other calls of this method are being "cached".
*
* @return $corePath Base path (core) for all includes
*/
protected static final function detectCorePath () {
// Is it not set?
if (empty(self::$corePath)) {
// Auto-detect our core path
self::$corePath = str_replace("\\", '/', dirname(__FILE__));
} // END - if
// Return it
return self::$corePath;
}
/**
* The application's main entry point. This class isolates some local
* variables which shall not become visible to outside because of security
* concerns. We are doing this here to "emulate" the well-known entry
* point in Java.
*
* @return void
*/
public static final function main () {
// Load config file
require(self::detectCorePath() . '/inc/config.php');
// Load all include files
require($cfg->getConfigEntry('base_path') . 'inc/includes.php');
// Load all framework classes
require($cfg->getConfigEntry('base_path') . 'inc/classes.php');
// Include the application selector
require($cfg->getConfigEntry('base_path') . 'inc/selector.php');
} // END - main()
} // END - class
// Developer mode active? Comment out if no dev!
define('DEVELOPER', TRUE);
// Log all exceptions (only debug! This option can create large error logs)
//define('LOG_EXCEPTIONS', TRUE);
//xdebug_start_trace();
// Do not remove the following line:
ApplicationEntryPoint::main();
// [EOF]
?>