initializing framework refactoring completed

1 files changed, 24 insertions, 15 deletions

diff --git a/public/app/config/setup_framework.php b/public/app/config/setup_framework.php
index 69c3402..384a643 100644
--- a/public/app/config/setup_framework.php
+++ b/public/app/config/setup_framework.php
@@ -47,7 +47,7 @@ if (file_exists(APP_ROOT ."/.env")) {
 
 
 
-/** ENVIRONMENT constant
+/** ENVIRONMENT constant ///////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * define application's environment stage; [PRODUCTION|staging|develpment|testing|*]
@@ -63,7 +63,7 @@ define('PRODUCTION', ($env['ENVIRONMENT'] == 'PRODUCTION') );
 
 
 
-/** APPLICATION NAMES AND URL DEFAULTS
+/** APPLICATION NAMES AND URL DEFAULTS /////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * NOTE:
@@ -88,12 +88,12 @@ define('SITE_URL', $env['ANOM_HOSTNAME']);
 
 
 
-/** APPLICATION PATHS
+/** APPLICATION PATHS //////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * Obligarory:
  * These are needed in order to run the bare minimum MVC system
- * They also make code easier to read
+ * They also make code easier to oranize and navigate into.
  * 
  * NOTE:
  * most likely you do not need to change any of these subsection defines;
@@ -134,7 +134,7 @@ define('AUTOLOADER' , APP_ROOT.'/vendor/autoload.php');
  * -----------------------------------------------------------------------------
  * 
  * NOTE: if the custom autoloadet is used
- * then you need to defing CLASSPATHS constant-array too;
+ * then you need to define CLASSPATHS constant-array too;
  */
 
 # define('AUTOLOADER' , '../core/helpers/autoload.php');
@@ -165,7 +165,7 @@ define('AUTOLOADER' , APP_ROOT.'/vendor/autoload.php');
 
 
 
-/** SESSION HANDLING
+/** SESSION HANDLING ///////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * there are several session drivers for session handling:
@@ -196,7 +196,7 @@ define('SESSION_DRIVER', $env['SESSION_DRIVER'] ?? 'DefaultSession');
 
 
 
-/** COOKIE SETTINGS
+/** COOKIE SETTINGS ////////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * Define cookie policy (cookie sharing and securing)
@@ -233,6 +233,7 @@ define('MAX_SESSION_LIFE', 2*60*60);    // maximum session lifetime (2 hours)
 
 
 
+
 /** SECURITY SETTINGS ///////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
@@ -259,7 +260,7 @@ define('CSRF_EXCLUDE_URIS', array());   // Array of URIs which ignore CSRF check
 
 
 
-/* ADVANCED OPTIMIZATION ///////////////////////////////////////////////////////
+/* CACHE DRIVER ////////////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  *
  * APP_CACHE defines the cache-driver;
@@ -269,11 +270,14 @@ define('CSRF_EXCLUDE_URIS', array());   // Array of URIs which ignore CSRF check
  * 'FileCache'  : caching in filesystem; fair if caching on HDD; great on SSD
  * 'RedisCache' : caching in Redis server; generally recommended if available
  * 'MemCachedCache' : caching in Memcached server; recommended if available
+ * 
+ * You can configure the caching parametres later on this file;
  *
- * NOTE: FileCache on a NVMe SDD is the fastest option;
+ * NOTE:
+ * Nowadays FileCache on a NVMe SDD seems to be the fastest option;
  * Redis and Memcached are really-fast caching options and are available for
- * scaling horizontaly your application (eache one has it's own strngths;
- * study, then choose the one that fulfills your needs;
+ * scaling horizontaly your application (each one having it's own strengths)
+ *
  * -----------------------------------------------------------------------------
  */
   
@@ -311,7 +315,9 @@ define('CACHE_DRIVER', $env['CACHE_DRIVER'] ?? 'FileCache');
  * /////////////////////////////////////////////////////////////////////////////
  */
 
-/** DATABASE CONNECTION PARAMETRES
+
+
+/** DATABASE CONNECTION PARAMETRES /////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * Production and staging environments may use different databases.
  * 
@@ -345,7 +351,7 @@ define('DB_TIMEZONE', "SET time_zone = 'Europe/Athens'");
  
  
  
-/** CACHED SERVICES
+/** CACHED SERVICES ////////////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * impemented services:
@@ -411,7 +417,7 @@ define('MEDIA_STORAGE_ROOT', APP_ROOT.'/storage/uploads/');    // Media files ro
 
 
 
-/** General Scope Constants
+/** General Scope Constants ////////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * needed by the framework for common tasks
@@ -423,6 +429,8 @@ define('MEDIA_STORAGE_ROOT', APP_ROOT.'/storage/uploads/');    // Media files ro
  * -----------------------------------------------------------------------------
  */
 
+
+
 /** COMMON CONTENT TYPES
  * -----------------------------------------------------------------------------
  */
@@ -449,6 +457,7 @@ define('COMMON_CONTENT_TYPES', array(
 );
 
 
+
 /** PROXY_FLAGS
  * -----------------------------------------------------------------------------
  * These options represend altered/non-default behaviour
@@ -461,7 +470,7 @@ define('PROXY_DO_NOT_CACHE', 4);  // do not cache result
 
 
 
-/** need even more constants?
+/** need even more constants? //////////////////////////////////////////////////
  * -----------------------------------------------------------------------------
  * 
  * Append them here,