X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=framework%2Fbootstrap%2Fclass_FrameworkBootstrap.php;h=cb8aaffde3a6b2eb0e4cd97058eb93becc9f8752;hb=31187ee9454944f638939eca8686b3d48f6769e6;hp=0864970fd68d75490852bce15549e29e9c15242d;hpb=c043deee4ad5b0f39830948b3ccd27f7fc38c193;p=core.git diff --git a/framework/bootstrap/class_FrameworkBootstrap.php b/framework/bootstrap/class_FrameworkBootstrap.php index 0864970f..cb8aaffd 100644 --- a/framework/bootstrap/class_FrameworkBootstrap.php +++ b/framework/bootstrap/class_FrameworkBootstrap.php @@ -1,24 +1,28 @@ getPathname(), 0, strlen($dir)) == $dir) { // Is reachable $isReachable = true; + + // Abort lookup as it has been found in open_basedir + break; } // END - if } // END - foreach } else { @@ -162,25 +195,21 @@ final class FrameworkBootstrap { * Checks whether the give file is within open_basedir() (done by * isReachableFilePath()), is actually a file and is readable. * - * @param $fileName Name of the file to be checked + * @param $fileInstance An instance of a SplFileInfo class * @return $isReadable Whether the file is readable (and therefor exists) */ - public static function isReadableFile ($fileName) { + public static function isReadableFile (SplFileInfo $fileInstance) { // Default is not readable $isReadable = false; - // Is within parameters, so check if it is a file and readable + // Check if it is a file and readable $isReadable = ( ( - self::isReachableFilePath($fileName) - ) && ( - file_exists($fileName) + self::isReachableFilePath($fileInstance) ) && ( - is_file($fileName) + $fileInstance->isFile() ) && ( - is_readable($fileName) - ) && ( - filesize($fileName) > 100 + $fileInstance->isReadable() ) ); @@ -191,22 +220,22 @@ final class FrameworkBootstrap { /** * Loads given include file * - * @param $fqfn Include's FQFN + * @param $fileInstance An instance of a SplFileInfo class * @return void - * @throws InvalidArgumentException If $fqfn was not found or not readable or deprecated + * @throws InvalidArgumentException If file was not found or not readable or deprecated */ - public static function loadInclude ($fqfn) { + public static function loadInclude (SplFileInfo $fileInstance) { // Trace message - //* NOISY-DEBUG: */ printf('[%s:%d]: fqfn=%s - CALLED!' . PHP_EOL, __METHOD__, __LINE__, $fqfn); + //* NOISY-DEBUG: */ printf('[%s:%d]: fileInstance=%s - CALLED!' . PHP_EOL, __METHOD__, __LINE__, $fileInstance); // Should be there ... - if (!self::isReadableFile($fqfn)) { + if (!self::isReadableFile($fileInstance)) { // Abort here - throw new InvalidArgumentException(sprintf('Cannot find fqfn=%s.', $fqfn)); + throw new InvalidArgumentException(sprintf('Cannot find fileInstance.pathname=%s.', $fileInstance->getPathname())); } // END - if // Load it - require $fqfn; + require_once $fileInstance->getPathname(); // Trace message //* NOISY-DEBUG: */ printf('[%s:%d]: EXIT!' . PHP_EOL, __METHOD__, __LINE__); @@ -219,12 +248,13 @@ final class FrameworkBootstrap { */ public static function doBootstrap () { // Load basic include files to continue bootstrapping - self::loadInclude(sprintf('%smain%sinterfaces%sclass_FrameworkInterface.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR)); - self::loadInclude(sprintf('%smain%sinterfaces%sregistry%sclass_Registerable.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR)); - self::loadInclude(sprintf('%sconfig%sclass_FrameworkConfiguration.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR)); + self::loadInclude(new SplFileInfo(sprintf('%smain%sinterfaces%sclass_FrameworkInterface.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR))); + self::loadInclude(new SplFileInfo(sprintf('%smain%sclasses%sclass_BaseFrameworkSystem.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR))); + self::loadInclude(new SplFileInfo(sprintf('%smain%sinterfaces%sregistry%sclass_Registerable.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR))); + self::loadInclude(new SplFileInfo(sprintf('%sconfig%sclass_FrameworkConfiguration.php', ApplicationEntryPoint::detectFrameworkPath(), DIRECTORY_SEPARATOR))); // Load global configuration - self::loadInclude(sprintf('%s%s', ApplicationEntryPoint::detectFrameworkPath(), 'config-global.php')); + self::loadInclude(new SplFileInfo(sprintf('%s%s', ApplicationEntryPoint::detectFrameworkPath(), 'config-global.php'))); } /** @@ -253,7 +283,7 @@ final class FrameworkBootstrap { /* * 3) Now, that there are all request parameters being available, check - * if 'app' is supplied. If it is not found, abort execution, if + * if 'application' is supplied. If it is not found, abort execution, if * found, continue below with next step. */ self::validateApplicationParameter(); @@ -268,25 +298,25 @@ final class FrameworkBootstrap { */ public static function prepareApplication () { // Configuration entry 'detected_app_name' must be set, get it here, including full path - $application = FrameworkConfiguration::getSelfInstance()->getConfigEntry('detected_app_name'); - $fullPath = FrameworkConfiguration::getSelfInstance()->getConfigEntry('detected_full_app_path'); + $application = self::getConfigurationInstance()->getConfigEntry('detected_app_name'); + $fullPath = self::getConfigurationInstance()->getConfigEntry('detected_full_app_path'); /* * Now check and load all files, found deprecated files will throw a * warning at the user. */ foreach (self::$configAppIncludes as $fileName => $status) { - // Construct FQFN - $fqfn = sprintf('%s%s.php', $fullPath, $fileName); + // Construct file instance + $fileInstance = new SplFileInfo(sprintf('%s%s.php', $fullPath, $fileName)); // Determine if this file is wanted/readable/deprecated - if (($status == 'required') && (!self::isReadableFile($fqfn))) { + if (($status == 'required') && (!self::isReadableFile($fileInstance))) { // Nope, required file cannot be found/read from - ApplicationEntryPoint::exitApplication(sprintf('Application "%s" does not have required file "%s.php". Please add it.', $application, $fileName)); - } elseif ((file_exists($fqfn)) && (!is_readable($fqfn))) { + ApplicationEntryPoint::exitApplication(sprintf('Application "%s" does not have required file "%s.php". Please add it.', $application, $fileInstance->getBasename())); + } elseif (($fileInstance->isFile()) && (!$fileInstance->isReadable())) { // Found, not readable file - ApplicationEntryPoint::exitApplication(sprintf('File "%s.php" from application "%s" cannot be read. Please fix CHMOD.', $fileName, $application)); - } elseif (($status != 'required') && (!self::isReadableFile($fqfn))) { + ApplicationEntryPoint::exitApplication(sprintf('File "%s.php" from application "%s" cannot be read. Please fix CHMOD.', $fileInstance->getBasename(), $application)); + } elseif (($status != 'required') && (!self::isReadableFile($fileInstance))) { // Not found but optional/deprecated file, skip it continue; } @@ -301,7 +331,7 @@ final class FrameworkBootstrap { } // END - if // Load it - self::loadInclude($fqfn); + self::loadInclude($fileInstance); } // END - foreach // Scan for application's classes, exceptions and interfaces @@ -316,46 +346,46 @@ final class FrameworkBootstrap { */ public static function startApplication () { // Configuration entry 'detected_app_name' must be set, get it here - $application = FrameworkConfiguration::getSelfInstance()->getConfigEntry('detected_app_name'); + $application = self::getConfigurationInstance()->getConfigEntry('detected_app_name'); // Is there an application helper instance? $applicationInstance = call_user_func_array( array( - 'CoreFramework\Helper\Application\ApplicationHelper', 'getSelfInstance' + 'Org\Mxchange\CoreFramework\Helper\Application\ApplicationHelper', 'getSelfInstance' ), array() ); // Some sanity checks if ((empty($applicationInstance)) || (is_null($applicationInstance))) { // Something went wrong! - ApplicationEntryPoint::exitApplication(sprintf("[Main:] The application %s could not be launched because the helper class %s is not loaded.", + ApplicationEntryPoint::exitApplication(sprintf('[Main:] The application %s could not be launched because the helper class %s is not loaded.', $application, - 'CoreFramework\Helper\Application\ApplicationHelper' + 'Org\Mxchange\CoreFramework\Helper\Application\ApplicationHelper' )); } elseif (!is_object($applicationInstance)) { // No object! - ApplicationEntryPoint::exitApplication(sprintf("[Main:] The application %s could not be launched because 'app' is not an object (%s).", + ApplicationEntryPoint::exitApplication(sprintf('[Main:] The application %s could not be launched because 'app' is not an object (%s).', $application, gettype($applicationInstance) )); } elseif (!($applicationInstance instanceof ManageableApplication)) { // Missing interface - ApplicationEntryPoint::exitApplication(sprintf("[Main:] The application %s could not be launched because 'app' is lacking required interface ManageableApplication.", + ApplicationEntryPoint::exitApplication(sprintf('[Main:] The application %s could not be launched because 'app' is lacking required interface ManageableApplication.', $application )); } // Set it in registry - Registry::getRegistry()->addInstance('app', $applicationInstance); + GenericRegistry::getRegistry()->addInstance('application', $applicationInstance); // Now call all methods in one go foreach (array('setupApplicationData', 'initApplication', 'launchApplication') as $methodName) { // Debug message - //* NOISY-DEBUG: */ printf('[%s:%d]: Calling methodName=%s ...' . PHP_EOL, __METHOD__, __LINE__, $methodName); + //*NOISY-DEBUG: */ printf('[%s:%d]: Calling methodName=%s ...' . PHP_EOL, __METHOD__, __LINE__, $methodName); // Call method call_user_func(array($applicationInstance, $methodName)); - } // END - if + } // END - foreach } /** @@ -368,13 +398,13 @@ final class FrameworkBootstrap { $applicationInstance = ApplicationHelper::getSelfInstance(); // Is the database instance already set? - if ($applicationInstance instanceof DatabaseConnector) { + if ($applicationInstance->getDatabaseInstance() instanceof DatabaseConnector) { // Yes, then abort here throw new BadMethodCallException('Method called twice.'); } // END - if // Initialize database layer - $databaseInstance = ObjectFactory::createObjectByConfiguredName(FrameworkConfiguration::getSelfInstance()->getConfigEntry('database_type') . '_class'); + $databaseInstance = ObjectFactory::createObjectByConfiguredName(self::getConfigurationInstance()->getConfigEntry('database_type') . '_class'); // Prepare database instance $connectionInstance = DatabaseConnection::createDatabaseConnection(DebugMiddleware::getSelfInstance(), $databaseInstance); @@ -383,6 +413,150 @@ final class FrameworkBootstrap { $applicationInstance->setDatabaseInstance($connectionInstance); } + /** + * Detects the server address (SERVER_ADDR) and set it in configuration + * + * @return $serverAddress The detected server address + * @throws UnknownHostnameException If SERVER_NAME cannot be resolved to an IP address + * @todo Have to check some more entries from $_SERVER here + */ + public static function detectServerAddress () { + // Is the entry set? + if (!isset(self::$serverAddress)) { + // Is it set in $_SERVER? + if (!empty($_SERVER['SERVER_ADDR'])) { + // Set it from $_SERVER + self::$serverAddress = $_SERVER['SERVER_ADDR']; + } elseif (isset($_SERVER['SERVER_NAME'])) { + // Resolve IP address + $serverIp = ConsoleTools::resolveIpAddress($_SERVER['SERVER_NAME']); + + // Is it valid? + if ($serverIp === false) { + /* + * Why is gethostbyname() returning the host name and not + * false as many other PHP functions are doing? ;-( + */ + throw new UnknownHostnameException(sprintf('Cannot resolve "%s" to an IP address. Please fix your setup.', $_SERVER['SERVER_NAME'])); + } // END - if + + // Al fine, set it + self::$serverAddress = $serverIp; + } else { + // Run auto-detecting through console tools lib + self::$serverAddress = ConsoleTools::acquireSelfIpAddress(); + } + } // END - if + + // Return it + return self::$serverAddress; + } + + /** + * Setter for default time zone (must be correct!) + * + * @param $timezone The timezone string (e.g. Europe/Berlin) + * @return $success If timezone was accepted + * @throws NullPointerException If $timezone is NULL + * @throws InvalidArgumentException If $timezone is empty + */ + public static function setDefaultTimezone ($timezone) { + // Is it null? + if (is_null($timezone)) { + // Throw NPE + throw new NullPointerException(NULL, BaseFrameworkSystem::EXCEPTION_IS_NULL_POINTER); + } elseif (!is_string($timezone)) { + // Is not a string + throw new InvalidArgumentException(sprintf('timezone[]=%s is not a string', gettype($timezone))); + } elseif ((is_string($timezone)) && (empty($timezone))) { + // Entry is empty + throw new InvalidArgumentException('timezone is empty'); + } + + // Default success + $success = FALSE; + + /* + * Set desired time zone to prevent date() and related functions to + * issue an E_WARNING. + */ + $success = date_default_timezone_set($timezone); + + // Return status + return $success; + } + + /** + * Checks whether HTTPS is set in $_SERVER + * + * @return $isset Whether HTTPS is set + * @todo Test more fields + */ + public static function isHttpSecured () { + return (isset($_SERVER['HTTPS'])); + } + + /** + * Dectect and return the base URL for all URLs and forms + * + * @return $baseUrl Detected base URL + */ + public static function detectBaseUrl () { + // Initialize the URL + $protocol = 'http'; + + // Do we have HTTPS? + if (self::isHttpSecured()) { + // Add the >s< for HTTPS + $protocol = 's'; + } // END - if + + // Construct the full URL and secure it against CSRF attacks + $baseUrl = sprintf('%s://%s%s', $protocol, self::detectDomain(), self::detectScriptPath()); + + // Return the URL + return $baseUrl; + } + + /** + * Detect safely and return the full domain where this script is installed + * + * @return $fullDomain The detected full domain + */ + public static function detectDomain () { + // Full domain is localnet.invalid by default + $fullDomain = 'localnet.invalid'; + + // Is the server name there? + if (isset($_SERVER['SERVER_NAME'])) { + // Detect the full domain + $fullDomain = htmlentities(strip_tags($_SERVER['SERVER_NAME']), ENT_QUOTES); + } // END - if + + // Return it + return $fullDomain; + } + + /** + * Detect safely the script path without trailing slash which is the glue + * between "http://your-domain.invalid/" and "script-name.php" + * + * @return $scriptPath The script path extracted from $_SERVER['SCRIPT_NAME'] + */ + public static function detectScriptPath () { + // Default is empty + $scriptPath = ''; + + // Is the scriptname set? + if (isset($_SERVER['SCRIPT_NAME'])) { + // Get dirname from it and replace back-slashes with slashes for lame OSes... + $scriptPath = str_replace("\\", '/', dirname($_SERVER['SCRIPT_NAME'])); + } // END - if + + // Return it + return $scriptPath; + } + /** * 1) Loads class scanner and scans all framework's classes and interfaces. * This method also registers the class loader's method autoLoad() for the @@ -397,10 +571,10 @@ final class FrameworkBootstrap { */ private static function scanFrameworkClasses () { // Include the class loader function - require FrameworkConfiguration::getSelfInstance()->getConfigEntry('framework_base_path') . 'loader/class_ClassLoader.php'; + require self::getConfigurationInstance()->getConfigEntry('framework_base_path') . 'loader/class_ClassLoader.php'; // Register auto-load function with the SPL - spl_autoload_register('CoreFramework\Loader\ClassLoader::autoLoad'); + spl_autoload_register('Org\Mxchange\CoreFramework\Loader\ClassLoader::autoLoad'); // Scan for all framework classes, exceptions and interfaces ClassLoader::scanFrameworkClasses(); @@ -418,7 +592,7 @@ final class FrameworkBootstrap { $requestType = self::getRequestTypeFromSystem(); // Create a new request object - $requestInstance = ObjectFactory::createObjectByName(sprintf('CoreFramework\Request\%sRequest', BaseFrameworkSystem::convertToClassName($request))); + $requestInstance = ObjectFactory::createObjectByName(sprintf('Org\Mxchange\CoreFramework\Request\%sRequest', BaseFrameworkSystem::convertToClassName($request))); // Remember request instance here self::setRequestInstance($requestInstance); @@ -431,7 +605,7 @@ final class FrameworkBootstrap { } // END - if // ... and a new response object - $responseClass = sprintf('CoreFramework\Response\%sResponse', BaseFrameworkSystem::convertToClassName($request)); + $responseClass = sprintf('Org\Mxchange\CoreFramework\Response\%sResponse', BaseFrameworkSystem::convertToClassName($request)); $responseInstance = ObjectFactory::createObjectByName($responseClass); // Remember response instance here @@ -439,7 +613,7 @@ final class FrameworkBootstrap { } /** - * 3) Validate parameter 'app' if it is set and the application is there. + * 3) Validate parameter 'application' if it is set and the application is there. * * @return void */ @@ -466,7 +640,7 @@ final class FrameworkBootstrap { // Construct FQPN (Full-Qualified Path Name) for ApplicationHelper class $applicationPath = sprintf( '%s%s%s', - FrameworkConfiguration::getSelfInstance()->getConfigEntry('application_base_path'), + self::getConfigurationInstance()->getConfigEntry('application_base_path'), $application, DIRECTORY_SEPARATOR ); @@ -479,8 +653,8 @@ final class FrameworkBootstrap { } // END - if // Set the detected application's name and full path for later usage - FrameworkConfiguration::getSelfInstance()->setConfigEntry('detected_full_app_path', $applicationPath); - FrameworkConfiguration::getSelfInstance()->setConfigEntry('detected_app_name' , $application); + self::getConfigurationInstance()->setConfigEntry('detected_full_app_path', $applicationPath); + self::getConfigurationInstance()->setConfigEntry('detected_app_name' , $application); } /** * Setter for request instance