mego dibil

README.md

@@ -1,10 +1,8 @@
 # MINIMAL
-The best code-to-utility Framework
+The best code-to-utility framework
 
 ## Nearest plans (2025)
-1. **Middlewares** technology
+1. Routes sorting `router::sort()`
-2. Route sorting `router::sort()`
-3. Processing routes from within routes (request emulation)
 
 ## Installation 
 Execute: `composer require mirzaev/minimal`
@@ -28,21 +26,3 @@ $core->router
 // Handling the request
 $core->start();
 ```
-
-## Projects based on MINIMAL
-
-### ebala
-**Repository:** https://git.svoboda.works/mirzaev/ebala<br>
-**Github mirror:** https://github.com/mature-woman/ebala<br>
-*I earned more than a **million rubles** from this project*<br>
-*Repositories **may** be closed at the request of the customer*<br>
-
-### Arming 
-**Repository:** https://git.svoboda.works/weby/arming<br>
-**Guthub mirror:** https://github.com/WEBY-GROUP/arming<br>
-*Telegram chat-robot marketplace*<br>
-
-### not.chat
-**Repository:** https://git.svoboda.works/mirzaev/notchat<br>
-**Github mirror:** https://github.com/mature-woman/notchat<br>
-*P2P chat project with blockchains and smart stuff*<br>

composer.json

@@ -1,14 +1,14 @@
 {
     "name": "mirzaev/minimal",
     "type": "framework",
-    "description": "My vision of a good framework",
+    "description": "The best code-to-utility framework",
     "keywords": [
         "mvc",
         "framework",
         "lightweight"
     ],
     "license": "WTFPL",
-    "homepage": "https://git.mirzaev.sexy/mirzaev/minimal",
+    "homepage": "https://git.svoboda.works/mirzaev/minimal",
     "authors": [
         {
             "name": "Arsen Mirzaev Tatyano-Muradovich",
@@ -18,8 +18,8 @@
         }
     ],
     "support": {
-        "docs": "https://git.mirzaev.sexy/mirzaev/minimal/wiki",
+        "docs": "https://git.svoboda.works/mirzaev/minimal/wiki",
-        "issues": "https://git.mirzaev.sexy/mirzaev/minimal/issues"
+        "issues": "https://git.svoboda.works/mirzaev/minimal/issues"
     },
     "require": {
         "php": "~8.4"

mirzaev/minimal/system/core.php

@@ -14,7 +14,8 @@ use mirzaev\minimal\router,
 	mirzaev\minimal\http\enumerations\status;
 
 // Built-in libraries
-use exception,
+use Closure as closure,
+	Exception as exception,
 	RuntimeException as exception_runtime,
 	BadMethodCallException as exception_method,
 	DomainException as exception_domain,
@@ -113,7 +114,27 @@ final class core
 	 */
 	public function start(): ?string
 	{
-		// Handle request and exit (success)
+		if (php_sapi_name() === 'cli') {
+			// Processing from CLI
+
+			// Initializing options
+			$options = getopt('', [
+				'method::',
+				'uri::',
+				'protocol::'
+			]);
+
+			// Writing method into the environment constant
+			$_SERVER["REQUEST_METHOD"] = $options['method'] ?? 'GET';
+
+			// Writing URI into the environment constant
+			$_SERVER['REQUEST_URI'] =  $options['uri'] ?? '/';
+
+			// Writing verstion of HTTP protocol into the environment constant
+			$_SERVER['SERVER_PROTOCOL'] = $options['protocol'] ?? 'CLI';
+		}
+
+		// Processing the request and exit (success)
 		return $this->request(new request(environment: true));
 	}
 
@@ -123,29 +144,26 @@ final class core
 	 * Handle request
 	 *
 	 * @param request $request The request
-	 * @paam array $parameters parameters for merging with route parameters
+	 * @param array $parameters parameters for merging with route parameters
 	 *
 	 * @return string|null Response 
 	 */
 	public function request(request $request, array $parameters = []): ?string
 	{
-		// Matching a route 
+		// Matching the route 
 		$route = $this->router->match($request);
 
 		if ($route) {
-			// Initialized a route
+			// Initialized the route
 
 			if (!empty($parameters)) {
 				// Recaived parameters
 
-				// Merging parameters with route parameters
+				// Merging parameters with the route parameters
 				$route->parameters = $parameters + $route->parameters;
 			}
 
-			// Writing request options from route options
+			// Exit (success)
-			$request->options = $route->options;
-
-			// Handling a route and exit (success)
 			return $this->route($route, $request);
 		}
 
@@ -232,15 +250,46 @@ final class core
 			// Found the method of the controller
 
 			try {
-				// Executing method of the controller and exit (success)
+				// Preparing the route function
-				return $route->controller->{$route->method}(...($route->parameters + $request->parameters));
+				$action = function() use ($request, $route): string {
+					// Writing the request options from the route options
+					$request->options = $route->options;
+
+					// Processing the method of the controller and exit (success)
+					$action = fn(): string => (string) $route->controller->{$route->method}(...($route->parameters + $request->parameters));
+
+					foreach ($route->middlewares as $middleware) {
+						// Iterating over the route middlewares
+
+						// Preparing the middleware function
+						$action = fn(): string => $middleware(next: $action, controller: $route->controller);
+					}
+
+					// Processing middlewares and the route functions
+					$response = $action();
+
+					// Exit (success)
+					return $response;
+				};
+
+				foreach ($this->router->middlewares as $middleware) {
+					// Iterating over the router middlewares
+
+					// Preparing the middleware function
+					$action = fn(): string => $middleware(next: $action, controller: $route->controller);
+				}
+
+				// Processing middlewares and the router request function
+				$response = $action();
+
+				// Exit (success)
+				return $response;
 			} catch (exception $exception) {
 				// Catched an exception
 
 				// Exit (fail)
 				throw new exception_runtime('Caught an error while processing the route', status::internal_server_error->value, $exception);
 			}
-
 		} else {
 			// Not found the method of the controller
 

mirzaev/minimal/system/http/enumerations/protocol.php

@@ -21,4 +21,6 @@ enum protocol: string
 	case http_1_1 = 'HTTP/1.1';
 	case http_1 = 'HTTP/1.0';
 	case http_0_9 = 'HTTP/0.9';
+
+	case cli = 'CLI';
 }

mirzaev/minimal/system/http/request.php

@@ -6,16 +6,16 @@ namespace mirzaev\minimal\http;
 
 // Files of the project
 use mirzaev\minimal\http\enumerations\method,
-mirzaev\minimal\http\enumerations\protocol,
+	mirzaev\minimal\http\enumerations\protocol,
-mirzaev\minimal\http\enumerations\status,
+	mirzaev\minimal\http\enumerations\status,
-mirzaev\minimal\http\enumerations\content,
+	mirzaev\minimal\http\enumerations\content,
-mirzaev\minimal\http\response;
+	mirzaev\minimal\http\response;
 
 // Built-in libraries
 use DomainException as exception_domain,
-InvalidArgumentException as exception_argument,
+	InvalidArgumentException as exception_argument,
-RuntimeException as exception_runtime,
+	RuntimeException as exception_runtime,
-LogicException as exception_logic;
+	LogicException as exception_logic;
 
 /**
  * Request
@@ -280,16 +280,16 @@ final class request
 
 			// Writing
 			$this->options = array_filter(
-			$value,
+				$value,
-			fn(string $key) => match ($key) {
+				fn(string $key) => match ($key) {
-				'post_max_size',
+					'post_max_size',
-				'max_input_vars',
+					'max_input_vars',
-				'max_multipart_body_parts',
+					'max_multipart_body_parts',
-				'max_file_uploads',
+					'max_file_uploads',
-				'upload_max_filesize' => true,
+					'upload_max_filesize' => true,
-				default => throw new exception_domain("Failed to recognize option: $key", status::internal_server_error->value)
+					default => throw new exception_domain("Failed to recognize option: $key", status::internal_server_error->value)
-			},
+				},
-			ARRAY_FILTER_USE_KEY
+				ARRAY_FILTER_USE_KEY
 			);
 		}
 
@@ -335,36 +335,42 @@ final class request
 		if (isset($protocol))
 			$this->protocol = $protocol;
 
-		if (isset($headers)) {
+		// Declaring the buffer of headers
-			// Received headers
+		$buffer = [];
 
-			// Declaring the buffer of headers
+		foreach (
-			$buffer = [];
+			match (true) {
+				isset($headers) => $headers,
+				php_sapi_name() !== 'cli' => getallheaders(),
+				default => []
+			} as $name => $value
+		) {
+			// Iterating over headers
 
-			foreach ($headers ?? [] as $name => $value) {
+			// Normalizing name of header (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2)
-				// Iterating over headers
+			$name = mb_strtolower($name, 'UTF-8');
 
-				// Normalizing name of header (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2)
+			if (empty($name)) {
-				$name = mb_strtolower($name, 'UTF-8');
+				// Not normalized name of header
 
-				if (empty($name)) {
+				// Exit (fail)
-					// Not normalized name of header
+				throw new exception_domain('Failed to normalize name of header', status::internal_server_error->value);
-
-					// Exit (fail)
-					throw new exception_domain('Failed to normalize name of header', status::internal_server_error->value);
-				}
-
-				// Writing into the buffer of headers
-				$buffer[$name] = $value;
 			}
 
-			// Writing headers from argument into the property
+			// Writing into the buffer of headers
-			$this->headers = $buffer;
+			$buffer[$name] = $value;
-
-			// Deinitializing the buffer of headers
-			unset($buffer);
 		}
 
+		if (!empty($buffer)) {
+			// Initialized at lease one header
+
+			// Writing headers into the property
+			$this->headers = $buffer;
+		}
+
+		// Deinitializing the buffer of headers
+		unset($buffer);
+
 		// Writing parameters from argument into the property
 		if (isset($parameters))
 			$this->parameters = $parameters;
@@ -385,36 +391,6 @@ final class request
 			// Writing verstion of HTTP protocol from environment into the property
 			$this->protocol ??= $_SERVER['SERVER_PROTOCOL'];
 
-			if (!isset($headers)) {
-				// Received headers
-
-				// Declaring the buffer of headers
-				$buffer = [];
-
-				foreach (getallheaders() ?? [] as $name => $value) {
-					// Iterating over headers
-
-					// Normalizing name of header (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2)
-					$name = mb_strtolower($name, 'UTF-8');
-
-					if (empty($name)) {
-						// Not normalized name of header
-
-						// Exit (fail)
-						throw new exception_domain('Failed to normalize name of header', status::internal_server_error->value);
-					}
-
-					// Writing into the buffer of headers
-					$buffer[$name] = $value;
-				}
-
-				// Writing headers from environment into the property
-				$this->headers = $buffer;
-
-				// Deinitializing the buffer of headers
-				unset($buffer);
-			}
-
 			if (str_starts_with($this->headers['content-type'] ?? '', content::json->value)) {
 				// The body contains "application/json"
 

mirzaev/minimal/system/middleware.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mirzaev\minimal;
+
+// Files of the project
+use mirzaev\minimal\http\request,
+	mirzaev\minimal\controller,
+	mirzaev\minimal\route;
+
+// Built-in libraries
+use Closure as closure;
+
+/**
+ * Middleware
+ *
+ * @see https://en.wikipedia.org/wiki/Middleware Middlewares
+ *
+ * @package mirzaev\minimal
+ *
+ * @param closure $function Function
+ *
+ * @method void __construct(closure $function) Constructor
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ */
+final class middleware
+{
+	/**
+	 * Function
+	 * 
+	 * @var closure $function Function
+	 */
+	 public readonly closure $function;
+
+	/**
+	 * Constructor
+	 *
+	 * @param closure $function Function
+	 *
+	 * @return void
+	 */
+	public function __construct(closure $function)
+	{
+		// Writing the function
+		$this->function = $function;
+	}
+
+	/**
+	 * Invoke
+	 *
+	 * @param callable $next
+	 * @param controller $controller
+	 *
+	 * @return string Output
+	 */
+	 public function __invoke(callable $next, controller $controller): string
+	 {
+		 // Processing the middleware (entering into recursion)
+		 return (string) ($this->function)(next: $next, controller: $controller);
+	 }
+}

mirzaev/minimal/system/route.php

@@ -4,6 +4,11 @@ declare(strict_types=1);
 
 namespace mirzaev\minimal;
 
+// Files of the project
+use mirzaev\minimal\controller,
+	mirzaev\minimal\middleware,
+	mirzaev\minimal\traits\middleware as middleware_trait;
+
 /**
  * Route
  *
@@ -14,14 +19,18 @@ namespace mirzaev\minimal;
  * @param string|model $model Name of the model
  * @param array $parameters Arguments for the $this->method (will be concatenated together with generated request parameters)
  * @param array $options Options for `request_parse_body($options)`
+ * @param array $middlewares Stack of middlewares
  *
- * @method void __construct(string|controller $controller, ?string $method, string|model|null $model, array $parameters, array $options) Constructor
+ * @method void __construct(string|controller $controller, ?string $method, string|model|null $model, array $parameters, array $options, array $middlewares) Constructor
+ * @method self middleware(middleware $middleware) Middleware
  *
  * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class route
 {
+	use middleware_trait;
+
 	/**
 	 * Controller
 	 * 
@@ -37,7 +46,7 @@ final class route
 	 * 
 	 * @var string $method Name of the method of the method of $this->controller
 	 */
-	public string $method{
+	public string $method {
 		// Read
 		get => $this->method;
 	}
@@ -69,8 +78,8 @@ final class route
 	 *
 	 * Required if $this->method !== method::post
 	 *
-	 * @see https://wiki.php.net/rfc/rfc1867-non-post about request_parse_body()
+	 * @see https://wiki.php.net/rfc/rfc1867-non-post About request_parse_body()
-	 * @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
+	 * @see https://wiki.php.net/rfc/property-hooks Hooks (find a table about backed and virtual hooks)
 	 *
 	 * @throws exception_runtime if reinitialize the property
 	 * 
@@ -78,7 +87,7 @@ final class route
 	 */
 	public array $options {
 		// Write
-		set (array $value) {
+		set(array $value) {
 			if (isset($this->{__PROPERTY__})) {
 				// The property is already initialized
 
@@ -113,6 +122,7 @@ final class route
 	 * @param string|model|null $model Name of the model
 	 * @param array $parameters Arguments for the $method (will be concatenated together with generated request parameters)
 	 * @param array $options Options for `request_parse_body` (Only for POST method)
+	 * @param array $middlewares Middlewares stack
 	 *
 	 * @return void
 	 */
@@ -121,7 +131,8 @@ final class route
 		?string $method = 'index',
 		string|model|null $model = null,
 		array $parameters = [],
-		array $options = []
+		array $options = [],
+		array $middlewares = []
 	) {
 		// Writing name of the controller
 		$this->controller = $controller;
@@ -135,6 +146,32 @@ final class route
 		// Writing parameters
 		$this->parameters = $parameters;
 
+		// Declaring the register of the middlewares stack validity
+		$stack = true;
+
+		foreach ($middlewares as $middleware) {
+			// Iterating over middlewares
+
+			if ($middleware instanceof middleware) {
+				// Initialized the middleware
+			} else {
+				// Not initialized the middleware
+
+				// Writing the register of the middlewares stack validity
+				$stack = false;
+
+				// Exit (fail)
+				break;
+			}
+		}
+
+		if ($stack) {
+			// The middlewares stack is valid
+
+			// Writing the middlewares stack
+			$this->middlewares = $middlewares;
+		}
+
 		// Writing options
 		if (match ($method) {
 			'GET', 'PUT', 'PATCH', 'DELETE' => true,

mirzaev/minimal/system/router.php

@@ -7,7 +7,8 @@ namespace mirzaev\minimal;
 // Files of the project
 use mirzaev\minimal\route,
 	mirzaev\minimal\http\request,
-	mirzaev\minimal\traits\singleton;
+	mirzaev\minimal\traits\singleton,
+	mirzaev\minimal\traits\middleware as middleware_trait;
 
 // Build-ing libraries
 use InvalidArgumentException as exception_argument;
@@ -21,15 +22,17 @@ use InvalidArgumentException as exception_argument;
  *
  * @method self write(string $urn, route $route, string|array $method) Write route to registry of routes (fluent interface)
  * @method route|null match(request $request) Match request URI with registry of routes
- * @method self sort() Sort routes (DEV)
+ * @method self sort() Sort routes (DEVELOPMENT)
  * @method string universalize(string $urn) Universalize URN
+ * @method self middleware(middleware $middleware) Middleware
+ * @param array $middlewares Stack of middlewares
  *
  * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class router
 {
-	use singleton;
+	use singleton, middleware_trait;
 
 	/**
 	 * Routes

mirzaev/minimal/system/traits/middleware.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mirzaev\minimal\traits;
+
+// Files of the project
+use mirzaev\minimal\middleware as instance;
+
+/**
+ * Trait of middleware
+ *
+ * @see https://en.wikipedia.org/wiki/Middleware Middlewares
+ *
+ * @package mirzaev\minimal\traits
+ *
+ * @param array $middlewares Stack of middlewares
+ *
+ * @method self middleware(middleware $middleware) Middleware
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ */
+trait middleware
+{
+	/**
+	 * Middlewares
+	 * 
+	 * @var array $middlewares The middlewares stack
+	 */
+	public array $middlewares = [] {
+		// Read
+		&get => $this->middlewares;
+	}
+
+	/**
+	 * Middleware
+	 *
+	 * Write the middleware into the middlewares stack
+	 *
+	 * @param instance $middleware The middleware
+	 *
+	 * @return self The instance from which the method was called (fluent interface)
+	 */
+	public function middleware(instance $middleware): self
+	{
+		// Writing into the middlewares stack
+		$this->middlewares[] = $middleware;
+
+		// Exit (success)
+		return $this;
+	}
+}