fixes bugs & errors

Router/MapRoute.php

@@ -13,7 +13,6 @@ class MapRoute extends Controller implements MapInterface
 {
 	private static string|array $route;
 	private static string $request_uri;
-	private static string $charset;
 	private static array $method;
 
 	/**
@@ -24,8 +23,6 @@ class MapRoute extends Controller implements MapInterface
 	 */
 	public function match(string $method, string|array $route): bool|array
 	{
-		$config_file = self::config_file();
-		self::$charset = $config_file['charset'] ?? 'UTF-8';
 		self::$method = explode('|', $method);
 		/**
 		 *   ----------------------------------------------
@@ -137,18 +134,12 @@ public function match(string $method, string|array $route): bool|array
 				exit('Method Not Allowed');
 			}
 
-			$charset = self::$charset;
-
-			http_response_code(200);
-			header("Content-Type: text/html; charset=$charset");
-
-			$s = [
+			return [
 				'method' => $_SERVER['REQUEST_METHOD'],
 				'route' => self::$route,
 				'params_value' => $req_value,
 				'params' => $req
 			];
-			return $s;
 		}
 
 		return false;
@@ -184,10 +175,6 @@ private function match_routing(): bool|array
 			}
 
 			$method = implode('|', self::$method);
-			$charset = self::$charset;
-
-			http_response_code(200);
-			header("Content-Type: text/html; charset=$charset");
 
 			return [
 				'method' => $_SERVER['REQUEST_METHOD'],

Router/Route.php

@@ -134,9 +134,6 @@ public static function config(): void
 		$file = is_file($file_url) ? file_get_contents($file_url) : null;
 
 		$file_type = $file !== null ? self::file_type($file_url) : null;
-		$config_file = self::config_file();
-
-		$charset = $config_file['charset'] ?? 'UTF-8';
 
 		/**
 		 *   ----------------------------------------------
@@ -161,14 +158,16 @@ public static function config(): void
 					http_response_code($http_code);
 
 					if ($contentType) {
-						header("Content-Type: $contentType; charset=$charset");
+						header("Content-Type: $contentType");
 					}
 
 					if ($components) {
 						print_r(view::render($components));
 					} elseif ($contents) {
 						print_r($contents);
 					}
+
+					self::log();
 					exit();
 				}
 			}
@@ -178,10 +177,10 @@ public static function config(): void
 			 *    Proceed to accepts current file
 			 *  -----------------------------------------------
 			 */
-			http_response_code(200);
-			header("Content-Type: $file_type; charset=$charset");
+			header("Content-Type: $file_type");
 
 			print_r($file);
+			self::log();
 			exit();
 		}
 	}

Router/view.php

@@ -5,33 +5,35 @@
 use PhpSlides\Exception;
 use PhpSlides\Logger\Logger;
 use PhpSlides\Traits\FileHandler;
-use PhpSlides\Controller\Controller;
 use PhpSlides\Foundation\Application;
 
 /**
- *   --------------------------------------------------------------
+ * --------------------------------------------------------------
+ * Router View
  *
- *   Router View
+ * This class controls public URL parsing and validation. It is responsible for rendering views
+ * and parsing public URLs within views.
  *
- *   Which control the public URL and validating.
- *   This class is used in rendering views and parsing public URL in views.
- *
- *   --------------------------------------------------------------
+ * --------------------------------------------------------------
  */
-final class view extends Controller
+final class view
 {
 	use Logger, FileHandler;
 
 	/**
-	 *   --------------------------------------------------------------
+	 * --------------------------------------------------------------
+	 * Render Views and Parse Public URL in Views
+	 *
+	 * This method is used to render a view by parsing the provided view name, validating
+	 * the path, and passing any additional parameters to the view file.
+	 * It returns the output from the view file as a result.
 	 *
-	 * Render views and parse public URL in views
+	 * @param string $view The name or path of the view to be rendered.
+	 * @param mixed ...$props Additional parameters to be passed into the view.
 	 *
-	 * @param string $view
-	 * @param mixed ...$props
-	 * @return mixed return the file gotten from the view parameters
+	 * @return mixed The rendered content of the view.
 	 *
-	 *   --------------------------------------------------------------
+	 * --------------------------------------------------------------
 	 */
 	final public static function render(string $view, mixed ...$props): mixed
 	{
@@ -41,6 +43,6 @@ final public static function render(string $view, mixed ...$props): mixed
 		$file_uri = Application::$viewsDir . $file;
 		header('Content-Type: text/html');
 
-		return self::slides_include($file_uri, ...$props);
+		return \psl($file_uri, ...$props);
 	}
 }

src/Bootstrap/App.php

@@ -1,3 +1,6 @@
 <?php
 
+/**
+ * Start the PhpSlides Application 
+ */
 (new \PhpSlides\Foundation\Application())->create();

src/Cache/Cache.php

@@ -5,26 +5,42 @@
 use PhpSlides\Foundation\Application;
 
 /**
- * Handles Cache Performance
+ * Class Cache
+ *
+ * This class handles cache management operations within the PhpSlides framework.
+ * It provides functionality to clear all cache or clear specific cache items,
+ * such as the hot reload cache.
  */
 class Cache
 {
 	/**
-	 * Clear all cache
+	 * Clears all cache stored in the 'app/cache' directory.
+	 *
+	 * This method checks if the cache directory exists and removes it,
+	 * effectively clearing all cached files. It is commonly used to
+	 * reset the cache during development or when cache corruption occurs.
 	 */
 	public function clear()
 	{
+		// Check if the cache directory exists
 		if (is_dir(Application::$basePath . 'app/cache')) {
+			// Remove the cache directory
 			rmdir(Application::$basePath . 'app/cache');
 		}
 	}
 
 	/**
-	 * Clear Hot Reload cache
+	 * Clears the Hot Reload cache specifically.
+	 *
+	 * This method checks if the 'hot-reload.json' cache file exists and removes it.
+	 * It is typically used during development when hot reload functionality
+	 * needs to be reset or reloaded.
 	 */
 	public function clearHotReload()
 	{
+		// Check if the hot-reload cache file exists
 		if (file_exists(Application::$basePath . 'app/cache/hot-reload.json')) {
+			// Delete the hot-reload cache file
 			unlink(Application::$basePath . 'app/cache/hot-reload.json');
 		}
 	}

src/Config/cors.php

@@ -19,20 +19,19 @@
 	header($header_value);
 }
 
-class Log
-{
-	use Logger;
-	public function __construct()
-	{
-		self::log();
-	}
-}
-
 /**
  * Handle preflight requests (OPTIONS method)
  */
 if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
+	class Log
+	{
+		use Logger;
+		public function __construct()
+		{
+			self::log();
+		}
+	}
+
 	new Log();
-	http_response_code(200);
 	exit();
 }

src/Controller/RouteController.php

@@ -41,23 +41,6 @@ protected static function config_file(): array|bool
 		}
 	}
 
-	/**
-	 *    -----------------------------------------------------------
-	 *    |
-	 *    @param string $filename The file which to gets the contents
-	 *    @param mixed ...$props Properties in which would be available in the file
-	 *    @return mixed The executed included file received
-	 *    |
-	 *    -----------------------------------------------------------
-	 */
-	public static function slides_include(
-		string $filename,
-		mixed ...$props
-	): mixed {
-		$loaded = (new ViewLoader())->load($filename, ...$props);
-		return $loaded->getLoad();
-	}
-
 	/**
 	 *    ==============================
 	 *    |    Don't use this function!!!
@@ -100,9 +83,6 @@ protected static function routing(
 				exit('Method Not Allowed');
 			}
 
-			header('Content-Type: */*');
-			http_response_code(200);
-
 			return $callback;
 		} else {
 			return false;

src/Database/Connection.php

@@ -4,8 +4,16 @@
 
 use DB;
 
+/**
+ * Class for managing database connections.
+ *
+ * The `Connection` class provides methods to connect, reconnect, and initialize
+ * the database connection parameters. It manages the environment variables used
+ * to configure the connection to a MySQL (or other DBMS) database.
+ */
 class Connection
 {
+	// Database connection parameters
 	public static $dsn;
 	public static $host;
 	public static $port;
@@ -14,29 +22,55 @@ class Connection
 	public static $db_type;
 	public static $password;
 
+	/**
+	 * Establish a connection to the database using environment variables.
+	 *
+	 * This method retrieves the database connection details from environment
+	 * variables (e.g., `DB_HOST`, `DB_USER`, `DB_PASS`) and constructs the DSN
+	 * for the connection. It then assigns the connection details to the static
+	 * properties used by the DB class.
+	 *
+	 * @return void
+	 */
 	static function connect()
 	{
+		// Set connection parameters from environment variables
 		static::$port = getenv('DB_PORT') ?: 3306;
 		static::$host = getenv('DB_HOST') ?: '0.0.0.0';
 		static::$user = getenv('DB_USER') ?: 'root';
 		static::$db_name = getenv('DB_BASE') ?: '';
 		static::$db_type = getenv('DB_CONN') ?: 'mysql';
 		static::$password = getenv('DB_PASS') ?: '';
 
+		// Construct DSN (Data Source Name) for the database connection
 		DB::$dsn = sprintf(
 			'%s:host=%s;port=%s;dbname=%s',
 			static::$db_type,
 			static::$host,
 			static::$port,
 			static::$db_name
 		);
+
+		// Set the user and password for the database connection
 		DB::$user = static::$user;
 		DB::$password = static::$password;
 	}
 
+	/**
+	 * Reconnect to the database.
+	 *
+	 * This method disconnects the current database connection and re-establishes it
+	 * using the updated connection parameters. It is useful for cases where the
+	 * database parameters need to be refreshed.
+	 *
+	 * @return void
+	 */
 	static function reconnect()
 	{
+		// Disconnect the current database connection
 		DB::disconnect();
+
+		// Recreate the DSN and reconnect with the new parameters
 		DB::$dsn = sprintf(
 			'%s:host=%s;port=%s;dbname=%s',
 			static::$db_type,
@@ -46,6 +80,15 @@ static function reconnect()
 		);
 	}
 
+	/**
+	 * Initialize the database connection parameters.
+	 *
+	 * This method ensures that the static properties of the `DB` class are initialized
+	 * with values from the `Connection` class or the environment variables. It helps
+	 * configure the connection before making any database queries.
+	 *
+	 * @return void
+	 */
 	static function init()
 	{
 		DB::$host = static::$host ?? getenv('DB_HOST') ?: 3306;