13 Commits
3.2.0 ... 3.7.2

11 changed files with 356 additions and 197 deletions

View File

@@ -1,14 +1,8 @@
The MINIMAL framework that does **not limit your project with its own rules**, has **no dependencies**, implements the **best practices** of popular MVC-frameworks, it **VERY fast** and **optimized** for all the innovations in **PHP 8.2** 🤟 # MINIMAL
The best code-to-utility framework
Can be configured to work with **any database** `core::$session` and **any HTML template engine** `$this->view` ## Nearest plans (2025)
*personally, i prefer **ArangoDB** and **Twig*** 1. Routes sorting `router::sort()`
## Nearest plans (first half of 2025)
1. Add **middlewares** technology
2. Route sorting in the router `router::sort()`
3. Add trigger routes from within routes
4. Think about adding asynchronous executions
5. Write an article describing the principles of the framework
## Installation ## Installation
Execute: `composer require mirzaev/minimal` Execute: `composer require mirzaev/minimal`
@@ -16,49 +10,19 @@ Execute: `composer require mirzaev/minimal`
## Usage ## Usage
*index.php* *index.php*
```php ```php
// Initializing the router
$router = new router;
// Initializing of routes
$router
->write('/', 'catalog', 'index', 'GET')
->write('/search', 'catalog', 'search', 'POST')
->write('/session/connect/telegram', 'session', 'telegram', 'POST')
->write('/product/$id', 'catalog', 'product', 'POST')
->write('/$categories...', 'catalog', 'index', 'POST'); // Collector (since 0.3.0)
// Initializing the core // Initializing the core
$core = new core(namespace: __NAMESPACE__, router: $router, controller: new controller(false), model: new model(false)); $core = new core(namespace: __NAMESPACE__);
// Handle the request // Initializing routes
echo $core->start(); $core->router
->write('/', new route('index', 'index'), 'GET')
->write('/search', new route('search', 'search'), 'POST')
->write('/product/create', new route('product', 'create'), 'PUT')
->write('/product/$id', new route('product', 'read'), 'GET')
->write('/product/$id', new route('product', 'read'), 'POST')
->write('/$categories', new route('categories', 'read'), 'GET') // Collector (since 0.3.0)
;
// Handling the request
$core->start();
``` ```
## Examples of projects based on MINIMAL
### ebala
**Repository:** https://git.mirzaev.sexy/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>
### huesos
**Repository:** https://git.mirzaev.sexy/mirzaev/huesos<br>
**Guthub mirror:** https://github.com/mature-woman/huesos<br>
*The basis for developing chat-robots with Web App technology (for example for Telegram)*<br>
### arming_bot
**Repository:** https://git.mirzaev.sexy/mirzaev/arming_bot<br>
**Guthub mirror:** https://github.com/mature-woman/arming_bot<br>
*Chat-robot based on huesos*<br>
### notchat
**Repository:** https://git.mirzaev.sexy/mirzaev/notchat<br>
**Github mirror:** https://github.com/mature-woman/notchat<br>
*P2P chat project with different blockchains and smart stuff*<br>
### site-repression
**Link:** https://repression.mirzaev.sexy<br>
**Repository:** https://git.mirzaev.sexy/mirzaev/site-repression<br>
**Github mirror:** https://github.com/mature-woman/site-repression<br>
*A simple site for my article about **political repressions in Russia** and my **kidnapping by Wagner PMC operatives** from my house*<br>

View File

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

View File

@@ -14,7 +14,8 @@ use mirzaev\minimal\router,
mirzaev\minimal\http\enumerations\status; mirzaev\minimal\http\enumerations\status;
// Built-in libraries // Built-in libraries
use exception, use Closure as closure,
Exception as exception,
RuntimeException as exception_runtime, RuntimeException as exception_runtime,
BadMethodCallException as exception_method, BadMethodCallException as exception_method,
DomainException as exception_domain, DomainException as exception_domain,
@@ -113,7 +114,27 @@ final class core
*/ */
public function start(): ?string 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)); return $this->request(new request(environment: true));
} }
@@ -123,29 +144,26 @@ final class core
* Handle request * Handle request
* *
* @param request $request The 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 * @return string|null Response
*/ */
public function request(request $request, array $parameters = []): ?string public function request(request $request, array $parameters = []): ?string
{ {
// Matching a route // Matching the route
$route = $this->router->match($request); $route = $this->router->match($request);
if ($route) { if ($route) {
// Initialized a route // Initialized the route
if (!empty($parameters)) { if (!empty($parameters)) {
// Recaived parameters // Recaived parameters
// Merging parameters with route parameters // Merging parameters with the route parameters
$route->parameters = $parameters + $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); return $this->route($route, $request);
} }
@@ -171,7 +189,7 @@ final class core
{ {
// Initializing name of the controller class // Initializing name of the controller class
$controller = $route->controller; $controller = $route->controller;
if ($route->controller instanceof controller) { if ($route->controller instanceof controller) {
// Initialized the controller // Initialized the controller
} else if (class_exists($controller = "$this->namespace\\controllers\\$controller")) { } else if (class_exists($controller = "$this->namespace\\controllers\\$controller")) {
@@ -195,36 +213,36 @@ final class core
unset($controller); unset($controller);
if (!isset($route->controller->model)) { if (!isset($route->controller->model)) {
// // Not initialized the model in the controller
// Initializing name if the model class // Initializing name if the model class
$model = $route->model; $model = $route->model;
if ($route->model instanceof model) { if ($route->model instanceof model) {
// Initialized the model // Initialized the model
} else if (class_exists($model = "$this->namespace\\models\\$model")) { } else if (class_exists($model = "$this->namespace\\models\\$model")) {
// Found the model by its name // Found the model by its name
// Initializing the model // Initializing the model
$route->model = new $model; $route->model = new $model;
} else if (!empty($route->model)) { } else if (!empty($route->model)) {
// Not found the model and $route->model has a value // Not found the model and $route->model has a value
// Exit (fail) // Exit (fail)
throw new exception_domain("Failed to find the model: $model", status::not_implemented->value); throw new exception_domain("Failed to find the model: $model", status::not_implemented->value);
}
// Deinitializing name of the model class
unset($model);
if ($route->model instanceof model) {
// Initialized the model
// Writing the model to the controller
$route->controller->model = $route->model;
}
} }
// Deinitializing name of the model class
unset($model);
if ($route->model instanceof model) {
// Initialized the model
// Writing the model to the controller
$route->controller->model = $route->model;
}
}
// Writing the request to the controller // Writing the request to the controller
$route->controller->request = $request; $route->controller->request = $request;
@@ -232,18 +250,49 @@ final class core
// Found the method of the controller // Found the method of the controller
try { 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 {
} catch (exception $e) { // 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 // Catched an exception
// Exit (fail) // Exit (fail)
throw new exception_runtime(...$e); throw new exception_runtime('Caught an error while processing the route', status::internal_server_error->value, $exception);
} }
} else { } else {
// Not found the method of the controller // Not found the method of the controller
// Exit (fail) // Exit (fail)
throw new exception_method('Failed to find method of the controller: ' . $route->controller::class . "->$route->method()", status::not_implemented->value); throw new exception_method('Failed to find method of the controller: ' . $route->controller::class . "->$route->method()", status::not_implemented->value);
} }

View File

@@ -115,6 +115,7 @@ enum content: string
return match ($this) { return match ($this) {
self::jpeg => 'jpg', self::jpeg => 'jpg',
self::png => 'png', self::png => 'png',
self::webp => 'webp',
self::form, self::mixed, self::alternative, self::related => throw new exception_argument('Content can not have file extension', status::internal_server_error->value), self::form, self::mixed, self::alternative, self::related => throw new exception_argument('Content can not have file extension', status::internal_server_error->value),
default => throw new exception_domain('Failed to recognize content: ' . $this->value, status::not_found->value) default => throw new exception_domain('Failed to recognize content: ' . $this->value, status::not_found->value)
}; };

View File

@@ -16,9 +16,11 @@ namespace mirzaev\minimal\http\enumerations;
*/ */
enum protocol: string enum protocol: string
{ {
case http_3 = 'HTTP/3'; case http_3 = 'HTTP/3.0';
case http_2 = 'HTTP/2'; case http_2 = 'HTTP/2.0';
case http_1_1 = 'HTTP/1.1'; case http_1_1 = 'HTTP/1.1';
case http_1 = 'hTTP/1.0'; case http_1 = 'HTTP/1.0';
case http_0_9 = 'HTTP/0.9'; case http_0_9 = 'HTTP/0.9';
case cli = 'CLI';
} }

View File

@@ -51,7 +51,7 @@ final class request
*/ */
public method $method { public method $method {
// Write // Write
set (method|string $value) { set(method|string $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -61,23 +61,23 @@ final class request
if ($value instanceof method) { if ($value instanceof method) {
// Received implementation of the method // Received implementation of the method
// Writing // Writing
$this->method = $value; $this->method = $value;
} else { } else {
// Received a string literal (excected name of the method) // Received a string literal (excected name of the method)
// Initializing implementator of the method // Initializing implementator of the method
$method = method::{strtolower($value)}; $method = method::{strtolower($value)};
if ($method instanceof method) { if ($method instanceof method) {
// Initialized implementator of the method // Initialized implementator of the method
// Writing // Writing
$this->method = $method; $this->method = $method;
} else { } else {
// Not initialized implementator of the method // Not initialized implementator of the method
// Exit (fail) // Exit (fail)
throw new exception_domain('Failed to recognize method: ' . $value, status::not_implemented->value); throw new exception_domain('Failed to recognize method: ' . $value, status::not_implemented->value);
} }
@@ -96,7 +96,7 @@ final class request
*/ */
public string $uri { public string $uri {
// Write // Write
set (string $value) { set(string $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -121,7 +121,7 @@ final class request
*/ */
public protocol $protocol { public protocol $protocol {
// Write // Write
set (protocol|string $value) { set(protocol|string $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -131,23 +131,23 @@ final class request
if ($value instanceof protocol) { if ($value instanceof protocol) {
// Received implementation of HTTP version // Received implementation of HTTP version
// Writing // Writing
$this->protocol = $value; $this->protocol = $value;
} else { } else {
// Received a string literal (excected name of HTTP version) // Received a string literal (excected name of HTTP version)
// Initializing implementator of HTTP version // Initializing implementator of HTTP version
$protocol = protocol::tryFrom($value); $protocol = protocol::tryFrom($value);
if ($protocol instanceof protocol) { if ($protocol instanceof protocol) {
// Initialized implementator of HTTP version // Initialized implementator of HTTP version
// Writing // Writing
$this->protocol = $protocol; $this->protocol = $protocol;
} else { } else {
// Not initialized implementator of HTTP version // Not initialized implementator of HTTP version
// Exit (fail) // Exit (fail)
throw new exception_domain('Failed to recognize HTTP version: ' . $value, status::http_version_not_supported->value); throw new exception_domain('Failed to recognize HTTP version: ' . $value, status::http_version_not_supported->value);
} }
@@ -187,16 +187,16 @@ final class request
*/ */
public array $parameters { public array $parameters {
// Write // Write
set (array $value) { set(array $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
// Exit (fail) // Exit (fail)
throw new exception_runtime('The property is already initialized: ' . __PROPERTY__, status::internal_server_error->value); throw new exception_runtime('The property is already initialized: ' . __PROPERTY__, status::internal_server_error->value);
} }
// Writing // Writing
$this->parameters = $value; $this->parameters = $value;
} }
// Read // Read
@@ -222,7 +222,7 @@ final class request
*/ */
public array $files { public array $files {
// Write // Write
set (array $value) { set(array $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -233,14 +233,14 @@ final class request
if (isset($this->method)) { if (isset($this->method)) {
// Initialized method // Initialized method
if ($this->method->body()) { if ($this->method->body()) {
// Request with this method can has body // Request with this method can has body
// Writing // Writing
$this->files = $value; $this->files = $value;
} else { } else {
// Request with this method can not has body // Request with this method can not has body
// Exit (fail) // Exit (fail)
throw new exception_logic('Request with ' . $this->method->value . ' method can not has body therefore can not has files', status::internal_server_error->value); throw new exception_logic('Request with ' . $this->method->value . ' method can not has body therefore can not has files', status::internal_server_error->value);
} }
@@ -270,7 +270,7 @@ final class request
*/ */
public array $options { public array $options {
// Write // Write
set (array $value) { set(array $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -324,49 +324,60 @@ final class request
bool $environment = false bool $environment = false
) { ) {
// Writing method from argument into the property // Writing method from argument into the property
if (isset($method)) $this->method = $method; if (isset($method))
$this->method = $method;
// Writing URI from argument into the property // Writing URI from argument into the property
if (isset($uri)) $this->uri = $uri; if (isset($uri))
$this->uri = $uri;
// Writing verstion of HTTP protocol from argument into the property // Writing verstion of HTTP protocol from argument into the property
if (isset($protocol)) $this->protocol = $protocol; if (isset($protocol))
$this->protocol = $protocol;
if (isset($headers)) { // Declaring the buffer of headers
// Received headers $buffer = [];
// Declaring the buffer of headers
$buffer = [];
foreach ($headers ?? [] as $name => $value) { foreach (
// Iterating over headers match (true) {
isset($headers) => $headers,
php_sapi_name() !== 'cli' => getallheaders(),
default => []
} as $name => $value
) {
// Iterating over headers
// Normalizing name of header (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2) // Normalizing name of header (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2)
$name = mb_strtolower($name, 'UTF-8'); $name = mb_strtolower($name, 'UTF-8');
if (empty($name)) { if (empty($name)) {
// Not normalized name of header // 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 // Exit (fail)
$buffer[$name] = $value; throw new exception_domain('Failed to normalize name of header', status::internal_server_error->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 // Writing parameters from argument into the property
if (isset($parameters)) $this->parameters = $parameters; if (isset($parameters))
$this->parameters = $parameters;
// Writing files from argument into the property // Writing files from argument into the property
if (isset($files)) $this->files = $files; if (isset($files))
$this->files = $files;
if ($environment) { if ($environment) {
// Requested to write values from environment // Requested to write values from environment
@@ -380,37 +391,7 @@ final class request
// Writing verstion of HTTP protocol from environment into the property // Writing verstion of HTTP protocol from environment into the property
$this->protocol ??= $_SERVER['SERVER_PROTOCOL']; $this->protocol ??= $_SERVER['SERVER_PROTOCOL'];
if (!isset($headers)) { if (str_starts_with($this->headers['content-type'] ?? '', content::json->value)) {
// 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 ($this->headers['content-type'] === content::json->value) {
// The body contains "application/json" // The body contains "application/json"
// Initializing data from the input buffer // Initializing data from the input buffer
@@ -438,10 +419,13 @@ final class request
// Writing files from environment into the property // Writing files from environment into the property
$this->files = $_FILES ?? []; $this->files = $_FILES ?? [];
} else if ($this->method->body()) { } else if ($this->method->body()) {
// Non POST method and can has body // Non POST method and can has body
if (match($this->headers['content-type']) { content::form->value, content::encoded->value => true, default => false }) { if (
str_starts_with($this->headers['content-type'], content::form->value) ||
str_starts_with($this->headers['content-type'], content::encoded->value)
) {
// Non POST method and the body content type is "multipart/form-data" or "application/x-www-form-urlencoded" // Non POST method and the body content type is "multipart/form-data" or "application/x-www-form-urlencoded"
// Writing parameters and files from environment into the properties // Writing parameters and files from environment into the properties
@@ -464,8 +448,10 @@ final class request
} }
// Validating of required properties // Validating of required properties
if (empty($this->method)) throw new exception_argument('Failed to initialize method of the request', status::internal_server_error->value); if (empty($this->method))
if (empty($this->uri)) throw new exception_argument('Failed to initialize URI of the request', status::internal_server_error->value); throw new exception_argument('Failed to initialize method of the request', status::internal_server_error->value);
if (empty($this->uri))
throw new exception_argument('Failed to initialize URI of the request', status::internal_server_error->value);
} }
/** /**
@@ -475,13 +461,13 @@ final class request
* *
* @return response Reponse for request * @return response Reponse for request
*/ */
public function response(): response public function response(): response
{ {
// Exit (success) // Exit (success)
return new response(protocol: $this->protocol, status: status::ok); return new response(protocol: $this->protocol, status: status::ok);
} }
/** /**
* Header * Header
* *
* Write a header to the headers property * Write a header to the headers property
@@ -493,7 +479,7 @@ final class request
* *
* @return self The instance from which the method was called (fluent interface) * @return self The instance from which the method was called (fluent interface)
*/ */
public function header(string $name, string $value): self public function header(string $name, string $value): self
{ {
// Normalizing name of header and writing to the headers property (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2) // Normalizing name of header and writing to the headers property (https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2)
$this->headers[mb_strtolower($name, 'UTF-8')] = $value; $this->headers[mb_strtolower($name, 'UTF-8')] = $value;

View File

@@ -320,7 +320,7 @@ final class response
*/ */
public function validate(request $request): self|false public function validate(request $request): self|false
{ {
if (str_contains($request->headers['accept'], $this->headers['content-type'] ?? '')) { if (str_contains($request->headers['accept'] ?? '', $this->headers['content-type'] ?? '')) {
// Validated with "accept" and "content-type" // Validated with "accept" and "content-type"
// Exit (success) // Exit (success)
@@ -453,10 +453,10 @@ final class response
flush(); flush();
// Deinitializing headers property // Deinitializing headers property
unset($this->headers); $this->headers = [];
// Deinitializing headers // Deinitializing headers
header_remove(); /* header_remove(); */
// Exit (success) // Exit (success)
return $this; return $this;

View File

@@ -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);
}
}

View File

@@ -4,6 +4,11 @@ declare(strict_types=1);
namespace mirzaev\minimal; namespace mirzaev\minimal;
// Files of the project
use mirzaev\minimal\controller,
mirzaev\minimal\middleware,
mirzaev\minimal\traits\middleware as middleware_trait;
/** /**
* Route * Route
* *
@@ -14,14 +19,18 @@ namespace mirzaev\minimal;
* @param string|model $model Name of the model * @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 $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 $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 * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy> * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/ */
final class route final class route
{ {
use middleware_trait;
/** /**
* Controller * Controller
* *
@@ -37,7 +46,7 @@ final class route
* *
* @var string $method Name of the method of the method of $this->controller * @var string $method Name of the method of the method of $this->controller
*/ */
public string $method{ public string $method {
// Read // Read
get => $this->method; get => $this->method;
} }
@@ -69,8 +78,8 @@ final class route
* *
* Required if $this->method !== method::post * 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 * @throws exception_runtime if reinitialize the property
* *
@@ -78,7 +87,7 @@ final class route
*/ */
public array $options { public array $options {
// Write // Write
set (array $value) { set(array $value) {
if (isset($this->{__PROPERTY__})) { if (isset($this->{__PROPERTY__})) {
// The property is already initialized // The property is already initialized
@@ -113,6 +122,7 @@ final class route
* @param string|model|null $model Name of the model * @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 $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 $options Options for `request_parse_body` (Only for POST method)
* @param array $middlewares Middlewares stack
* *
* @return void * @return void
*/ */
@@ -121,7 +131,8 @@ final class route
?string $method = 'index', ?string $method = 'index',
string|model|null $model = null, string|model|null $model = null,
array $parameters = [], array $parameters = [],
array $options = [] array $options = [],
array $middlewares = []
) { ) {
// Writing name of the controller // Writing name of the controller
$this->controller = $controller; $this->controller = $controller;
@@ -135,6 +146,32 @@ final class route
// Writing parameters // Writing parameters
$this->parameters = $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 // Writing options
if (match ($method) { if (match ($method) {
'GET', 'PUT', 'PATCH', 'DELETE' => true, 'GET', 'PUT', 'PATCH', 'DELETE' => true,

View File

@@ -7,7 +7,8 @@ namespace mirzaev\minimal;
// Files of the project // Files of the project
use mirzaev\minimal\route, use mirzaev\minimal\route,
mirzaev\minimal\http\request, mirzaev\minimal\http\request,
mirzaev\minimal\traits\singleton; mirzaev\minimal\traits\singleton,
mirzaev\minimal\traits\middleware as middleware_trait;
// Build-ing libraries // Build-ing libraries
use InvalidArgumentException as exception_argument; 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 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 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 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 * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy> * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/ */
final class router final class router
{ {
use singleton; use singleton, middleware_trait;
/** /**
* Routes * Routes

View File

@@ -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;
}
}