[feat] Added Exception classes and CSRF token class and other things

Author: MrAnyx

src/Exception/RedirectionException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace TimePHP\Exception;
+
+class RedirectionException extends \Exception {
+   
+   public function __construct($message = null, $code = 2000) {
+      if (!$message) {
+         throw new $this('Unknown ' . get_class($this));
+      }
+      parent::__construct($message, $code);
+   }
+
+   public function __toString(): string {
+      return __CLASS__ . "[{$this->code}] : {$this->message} at line {$this->line}";
+   }
+}

src/Exception/SessionException.php

@@ -2,14 +2,16 @@
 
 namespace TimePHP\Exception;
 
-class SessionException extends Exception {
+class SessionException extends \Exception {
 
-   public function __construct($message, $code = "1-000") {
+   public function __construct($message = null, $code = 1000) {
+      if (!$message) {
+         throw new $this('Unknown ' . get_class($this));
+      }
       parent::__construct($message, $code);
    }
 
-   // chaîne personnalisée représentant l'objet
-   public function __toString() {
-      return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
+   public function __toString(): string {
+      return __CLASS__ . "[{$this->code}] : {$this->message} at line {$this->line}";
    }
 }

src/Foundation/AbstractController.php

@@ -10,6 +10,9 @@
 
 use Twig\Environment;
 use TimePHP\Foundation\Router;
+use TimePHP\Security\CsrfToken;
+use TimePHP\Exception\SessionException;
+use TimePHP\Exception\RedirectionException;
 
 /**
  * @category Controller
@@ -51,4 +54,63 @@ public function generate(string $name, array $params = [], array $flags = []): s
         return Router::generate($name, $params, $flags);
     }
 
+    /**
+     * Create a session based on parameters
+     *
+     * @param array $params
+     * @return void
+     */
+    public function createSession(array $params): void {
+        if($params === null || empty($params) || count($params) === 0){
+            throw new SessionException("createSession function requires an array, null given", 1001);
+        } else if(count($_SESSION) > 0) {
+            throw new SessionException('A session has already been started', 1002);
+        } else {
+            $_SESSION["csrf_token"] = CsrfToken::generate();
+            foreach($params as $key => $value){
+                $_SESSION[$key] = $value;
+            }
+        }
+    }
+
+    /**
+     * Close the current session
+     *
+     * @return void
+     */
+    public function closeSession(): void {
+        if(count($_SESSION) === 0){
+            throw new SessionException('No session was created. $_SESSION is empty', 1003);
+        } else {
+            session_unset();
+            session_destroy();
+        }
+    }
+
+    /**
+     * Redirect to a url using a specific url
+     *
+     * @param string $url
+     * @return void
+     */
+    public function redirectUrl(string $url): void {
+        header("Location: $url");
+    }
+
+    /**
+     * Redirect to a url using a route name
+     *
+     * @param string $routeName
+     * @param array $params
+     * @param array $flags
+     * @return void
+     */
+    public function redirectRouteName(string $routeName, array $params = [], array $flags = []): void {
+        if(is_string($routeName)) {
+            header("Location: {$this->generate($routeName, $params, $flags)}");
+        } else {
+            throw new RedirectionException("$routeName doesn't exists");
+        }
+    }
+
 }

src/Foundation/Router.php

@@ -58,12 +58,7 @@ public static function generate(string $name, array $params = [], array $flags =
         if(count($flags) === 0){
             return $url;
         } else {
-            $index = 0;
-            foreach($flags as $key => $value){
-                $index === 0 ? $url.="?" : $url.="&";
-                $url.=$key."=".$value;
-                $index++;
-            }
+            $url .= "?".http_build_query($flags);
             return $url;
         }
     }

src/Security/CsrfToken.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace TimePHP\Security;
+
+class CsrfToken {
+ 
+   /**
+    * Generate a valid CSRF token
+    *
+    * @return string
+    */
+   public static function generate(): string {
+      return bin2hex(random_bytes(32));
+   }
+
+   /**
+    * Compare 2 hashes
+    *
+    * @param string $sessionToken
+    * @param string $inputToken
+    * @return boolean
+    */
+   public static function compare(string $sessionToken, string $inputToken): bool {
+      return hash_equals($sessionToken, $inputToken);
+   }
+   
+}