Compare commits
12 Commits
Author | SHA1 | Date | |
---|---|---|---|
4c7355bc03 | |||
df682e914e | |||
e93ea5825e | |||
c841250933 | |||
beaf55f00b | |||
7ae1d6ac70 | |||
d9e4e0af6c | |||
d5f4955070 | |||
74c3decaa6 | |||
e9f7cd39b6 | |||
476037b062 | |||
f936b70916 |
70
README.md
Normal file → Executable file
70
README.md
Normal file → Executable 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>
|
|
||||||
|
@@ -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"
|
||||||
|
@@ -11,12 +11,15 @@ use mirzaev\minimal\model,
|
|||||||
mirzaev\minimal\http\request,
|
mirzaev\minimal\http\request,
|
||||||
mirzaev\minimal\http\enumerations\status;
|
mirzaev\minimal\http\enumerations\status;
|
||||||
|
|
||||||
// Build-in libraries
|
// Built-in libraries
|
||||||
use exception;
|
use exception,
|
||||||
|
RuntimeException as exception_runtime;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Controller
|
* Controller
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal
|
||||||
|
*
|
||||||
* @var core $core An instance of the core
|
* @var core $core An instance of the core
|
||||||
* @var request $request Request
|
* @var request $request Request
|
||||||
* @var model $model An instance of the model connected in the core
|
* @var model $model An instance of the model connected in the core
|
||||||
@@ -24,8 +27,6 @@ use exception;
|
|||||||
*
|
*
|
||||||
* @method void __construct(core $core) Constructor
|
* @method void __construct(core $core) Constructor
|
||||||
*
|
*
|
||||||
* @package mirzaev\minimal
|
|
||||||
*
|
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
@@ -56,12 +57,32 @@ class controller
|
|||||||
/**
|
/**
|
||||||
* Model
|
* Model
|
||||||
*
|
*
|
||||||
|
* @throws exception_runtime if reinitialize the property
|
||||||
|
* @throws exception_runtime if an attempt to write null
|
||||||
|
*
|
||||||
* @var model $model An instance of the model connected in the core
|
* @var model $model An instance of the model connected in the core
|
||||||
*/
|
*/
|
||||||
public model $model {
|
public ?model $model = null {
|
||||||
// Write
|
// Write
|
||||||
set (model $model) {
|
set (model|null $model) {
|
||||||
$this->model ??= $model;
|
if (isset($this->{__PROPERTY__})) {
|
||||||
|
// The property is already initialized
|
||||||
|
|
||||||
|
// Exit (fail)
|
||||||
|
throw new exception_runtime('The property is already initialized: ' . __PROPERTY__, status::internal_server_error->value);
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($model instanceof model) {
|
||||||
|
// Validated model
|
||||||
|
|
||||||
|
// Writing
|
||||||
|
$this->model = $model;
|
||||||
|
} else {
|
||||||
|
// Not validated model
|
||||||
|
|
||||||
|
// Exit (fail)
|
||||||
|
throw new exception_runtime('The property must be an instance of model', status::internal_server_error->value);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Read
|
// Read
|
||||||
|
@@ -14,7 +14,9 @@ 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,
|
||||||
BadMethodCallException as exception_method,
|
BadMethodCallException as exception_method,
|
||||||
DomainException as exception_domain,
|
DomainException as exception_domain,
|
||||||
InvalidArgumentException as exception_argument,
|
InvalidArgumentException as exception_argument,
|
||||||
@@ -25,6 +27,8 @@ use exception,
|
|||||||
/**
|
/**
|
||||||
* Core
|
* Core
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal
|
||||||
|
*
|
||||||
* @param string $namespace Namespace where the core was initialized from
|
* @param string $namespace Namespace where the core was initialized from
|
||||||
* @param controller $controller An instance of the controller
|
* @param controller $controller An instance of the controller
|
||||||
* @param model $model An instance of the model
|
* @param model $model An instance of the model
|
||||||
@@ -36,8 +40,6 @@ use exception,
|
|||||||
* @method string|null request(request $request, array $parameters = []) Handle request
|
* @method string|null request(request $request, array $parameters = []) Handle request
|
||||||
* @method string|null route(route $route, string $method) Handle route
|
* @method string|null route(route $route, string $method) Handle route
|
||||||
*
|
*
|
||||||
* @package mirzaev\minimal
|
|
||||||
*
|
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
@@ -112,8 +114,41 @@ final class core
|
|||||||
*/
|
*/
|
||||||
public function start(): ?string
|
public function start(): ?string
|
||||||
{
|
{
|
||||||
// Handle request and exit (success)
|
if (php_sapi_name() === 'cli') {
|
||||||
return $this->request(new request(environment: true));
|
// 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';
|
||||||
|
}
|
||||||
|
|
||||||
|
// Preparing the route function
|
||||||
|
$action = fn(): string => (string) $this->request(new request(environment: true));
|
||||||
|
|
||||||
|
foreach ($this->router->middlewares as $middleware) {
|
||||||
|
// Iterating over the router middlewares
|
||||||
|
|
||||||
|
// Preparing the middleware function
|
||||||
|
$action = fn(): string => $middleware(next: $action);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Processing middlewares and the router request function
|
||||||
|
$response = $action();
|
||||||
|
|
||||||
|
// Exit (success)
|
||||||
|
return $response;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -122,30 +157,43 @@ 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
|
// Writing the request options from the route options
|
||||||
$request->options = $route->options;
|
$request->options = $route->options;
|
||||||
|
|
||||||
// Handling a route and exit (success)
|
// Preparing the route function
|
||||||
return $this->route($route, $request);
|
$action = fn(): string => (string) $this->route($route, $request);
|
||||||
|
|
||||||
|
foreach ($route->middlewares as $middleware) {
|
||||||
|
// Iterating over the route middlewares
|
||||||
|
|
||||||
|
// Preparing the middleware function
|
||||||
|
$action = fn(): string => $middleware(next: $action);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Processing middlewares and the route functions
|
||||||
|
$response = $action();
|
||||||
|
|
||||||
|
// Exit (success)
|
||||||
|
return $response;
|
||||||
}
|
}
|
||||||
|
|
||||||
// Exit (fail)
|
// Exit (fail)
|
||||||
@@ -170,7 +218,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")) {
|
||||||
@@ -193,31 +241,35 @@ final class core
|
|||||||
// Deinitializing name of the controller class
|
// Deinitializing name of the controller class
|
||||||
unset($controller);
|
unset($controller);
|
||||||
|
|
||||||
// Initializing name if the model class
|
if (!isset($route->controller->model)) {
|
||||||
$model = $route->model;
|
// Not initialized the model in the controller
|
||||||
|
|
||||||
if ($route->model instanceof model) {
|
// Initializing name if the model class
|
||||||
// Initialized the model
|
$model = $route->model;
|
||||||
} else if (class_exists($model = "$this->namespace\\models\\$model")) {
|
|
||||||
// Found the model by its name
|
|
||||||
|
|
||||||
// Initializing the model
|
if ($route->model instanceof model) {
|
||||||
$route->model = new $model;
|
// Initialized the model
|
||||||
} else if (!empty($route->model)) {
|
} else if (class_exists($model = "$this->namespace\\models\\$model")) {
|
||||||
// Not found the model and $route->model has a value
|
// Found the model by its name
|
||||||
|
|
||||||
// Exit (fail)
|
// Initializing the model
|
||||||
throw new exception_domain("Failed to find the model: $model", status::not_implemented->value);
|
$route->model = new $model;
|
||||||
}
|
} else if (!empty($route->model)) {
|
||||||
|
// Not found the model and $route->model has a value
|
||||||
|
|
||||||
// Deinitializing name of the model class
|
// Exit (fail)
|
||||||
unset($model);
|
throw new exception_domain("Failed to find the model: $model", status::not_implemented->value);
|
||||||
|
}
|
||||||
|
|
||||||
if ($route->model instanceof model) {
|
// Deinitializing name of the model class
|
||||||
// Initialized the model
|
unset($model);
|
||||||
|
|
||||||
// Writing the model to the controller
|
if ($route->model instanceof model) {
|
||||||
$route->controller->model = $route->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
|
||||||
@@ -226,11 +278,18 @@ final class core
|
|||||||
if (method_exists($route->controller, $route->method)) {
|
if (method_exists($route->controller, $route->method)) {
|
||||||
// Found the method of the controller
|
// Found the method of the controller
|
||||||
|
|
||||||
// Executing method of the controller and exit (success)
|
try {
|
||||||
return $route->controller->{$route->method}(...($route->parameters + $request->parameters));
|
// Executing method of the controller and exit (success)
|
||||||
|
return $route->controller->{$route->method}(...($route->parameters + $request->parameters));
|
||||||
|
} 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 {
|
} 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);
|
||||||
}
|
}
|
||||||
|
51
mirzaev/minimal/system/http/enumerations/content.php
Normal file → Executable file
51
mirzaev/minimal/system/http/enumerations/content.php
Normal file → Executable file
@@ -4,6 +4,13 @@ declare(strict_types=1);
|
|||||||
|
|
||||||
namespace mirzaev\minimal\http\enumerations;
|
namespace mirzaev\minimal\http\enumerations;
|
||||||
|
|
||||||
|
// Files of the project
|
||||||
|
use mirzaev\minimal\http\enumerations\status;
|
||||||
|
|
||||||
|
// Built-in libraries
|
||||||
|
use InvalidArgumentException as exception_argument,
|
||||||
|
DomainException as exception_domain;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Content
|
* Content
|
||||||
*
|
*
|
||||||
@@ -18,7 +25,7 @@ enum content: string
|
|||||||
{
|
{
|
||||||
case any = '*/*';
|
case any = '*/*';
|
||||||
|
|
||||||
// Text
|
// Text
|
||||||
|
|
||||||
case txt = 'text/plain';
|
case txt = 'text/plain';
|
||||||
case css = 'text/css';
|
case css = 'text/css';
|
||||||
@@ -26,7 +33,7 @@ enum content: string
|
|||||||
case html = 'text/html';
|
case html = 'text/html';
|
||||||
case js = 'text/javascript'; // js + mjs (https://www.rfc-editor.org/rfc/rfc9239#name-text-javascript)
|
case js = 'text/javascript'; // js + mjs (https://www.rfc-editor.org/rfc/rfc9239#name-text-javascript)
|
||||||
|
|
||||||
// Applications
|
// Applications
|
||||||
|
|
||||||
case binary = 'application/octet-stream';
|
case binary = 'application/octet-stream';
|
||||||
case encoded = 'application/x-www-form-urlencoded';
|
case encoded = 'application/x-www-form-urlencoded';
|
||||||
@@ -49,7 +56,7 @@ enum content: string
|
|||||||
case sh = 'application/x-sh';
|
case sh = 'application/x-sh';
|
||||||
case xhtml = 'application/xhtml+xml';
|
case xhtml = 'application/xhtml+xml';
|
||||||
|
|
||||||
// Audio
|
// Audio
|
||||||
|
|
||||||
case aac = 'audio/aac';
|
case aac = 'audio/aac';
|
||||||
case mp3 = 'audio/mpeg';
|
case mp3 = 'audio/mpeg';
|
||||||
@@ -57,8 +64,8 @@ enum content: string
|
|||||||
case oga = 'audio/ogg';
|
case oga = 'audio/ogg';
|
||||||
case weba = 'audio/webm';
|
case weba = 'audio/webm';
|
||||||
|
|
||||||
// Images
|
// Images
|
||||||
|
|
||||||
case gif = 'image/gif';
|
case gif = 'image/gif';
|
||||||
case jpeg = 'image/jpeg';
|
case jpeg = 'image/jpeg';
|
||||||
case png = 'image/png';
|
case png = 'image/png';
|
||||||
@@ -70,25 +77,47 @@ enum content: string
|
|||||||
case bmp = 'image/bmp';
|
case bmp = 'image/bmp';
|
||||||
case ico = 'image/vnd.microsoft.icon';
|
case ico = 'image/vnd.microsoft.icon';
|
||||||
|
|
||||||
// Videos
|
// Videos
|
||||||
|
|
||||||
case avi = 'video/x-msvideo';
|
case avi = 'video/x-msvideo';
|
||||||
case mp4 = 'video/mp4';
|
case mp4 = 'video/mp4';
|
||||||
case mpeg = 'video/mpeg';
|
case mpeg = 'video/mpeg';
|
||||||
case ogv = 'video/ogg';
|
case ogv = 'video/ogg';
|
||||||
case ts = 'video/mp2t';
|
case ts = 'video/mp2t';
|
||||||
|
|
||||||
// Fonts
|
// Fonts
|
||||||
|
|
||||||
case otf = 'font/otf';
|
case otf = 'font/otf';
|
||||||
case ttf = 'font/ttf';
|
case ttf = 'font/ttf';
|
||||||
case woff = 'font/woff';
|
case woff = 'font/woff';
|
||||||
case woff2 = 'font/woff2';
|
case woff2 = 'font/woff2';
|
||||||
|
|
||||||
// Multipart
|
// Multipart
|
||||||
|
|
||||||
case form = 'multipart/form-data';
|
case form = 'multipart/form-data';
|
||||||
case mixed = 'multipart/mixed';
|
case mixed = 'multipart/mixed';
|
||||||
case alternative = 'multipart/alternative';
|
case alternative = 'multipart/alternative';
|
||||||
case related = 'multipart/related';
|
case related = 'multipart/related';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extension
|
||||||
|
*
|
||||||
|
* Returns the file extension without a dot
|
||||||
|
*
|
||||||
|
* @throws exception_argument if content can not have file extension
|
||||||
|
* @throws exception_domain if failed to recognize content
|
||||||
|
*
|
||||||
|
* @return string File extension
|
||||||
|
*/
|
||||||
|
public function extension(): string
|
||||||
|
{
|
||||||
|
// Exit (success)
|
||||||
|
return match ($this) {
|
||||||
|
self::jpeg => 'jpg',
|
||||||
|
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),
|
||||||
|
default => throw new exception_domain('Failed to recognize content: ' . $this->value, status::not_found->value)
|
||||||
|
};
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
0
mirzaev/minimal/system/http/enumerations/method.php
Normal file → Executable file
0
mirzaev/minimal/system/http/enumerations/method.php
Normal file → Executable file
12
mirzaev/minimal/system/http/enumerations/protocol.php
Normal file → Executable file
12
mirzaev/minimal/system/http/enumerations/protocol.php
Normal file → Executable 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_0 = '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';
|
||||||
}
|
}
|
||||||
|
0
mirzaev/minimal/system/http/enumerations/status.php
Normal file → Executable file
0
mirzaev/minimal/system/http/enumerations/status.php
Normal file → Executable file
@@ -20,6 +20,8 @@ use DomainException as exception_domain,
|
|||||||
/**
|
/**
|
||||||
* Request
|
* Request
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal\http
|
||||||
|
*
|
||||||
* @param method $method Method
|
* @param method $method Method
|
||||||
* @param string $uri URI
|
* @param string $uri URI
|
||||||
* @param protocol $protocol Version of HTTP protocol
|
* @param protocol $protocol Version of HTTP protocol
|
||||||
@@ -32,8 +34,6 @@ use DomainException as exception_domain,
|
|||||||
* @method response response() Generate response for request
|
* @method response response() Generate response for request
|
||||||
* @method self header(string $name, string $value) Write a header to the headers property
|
* @method self header(string $name, string $value) Write a header to the headers property
|
||||||
*
|
*
|
||||||
* @package mirzaev\minimal\http
|
|
||||||
*
|
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
@@ -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;
|
||||||
|
@@ -20,6 +20,8 @@ use DomainException as exception_domain,
|
|||||||
/**
|
/**
|
||||||
* Response
|
* Response
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal\http
|
||||||
|
*
|
||||||
* @param protocol $protocol Version of HTTP protocol
|
* @param protocol $protocol Version of HTTP protocol
|
||||||
* @param status $status Status
|
* @param status $status Status
|
||||||
* @param array $headers Headers
|
* @param array $headers Headers
|
||||||
@@ -37,8 +39,6 @@ use DomainException as exception_domain,
|
|||||||
* @method self clean() Delete everything in the output buffer
|
* @method self clean() Delete everything in the output buffer
|
||||||
* @method self end() Initializes response headers and flushes the output buffer
|
* @method self end() Initializes response headers and flushes the output buffer
|
||||||
*
|
*
|
||||||
* @package mirzaev\minimal\http
|
|
||||||
*
|
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
@@ -49,7 +49,6 @@ final class response
|
|||||||
*
|
*
|
||||||
* @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
|
* @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
|
||||||
*
|
*
|
||||||
* @throws exception_runtime if reinitialize the property
|
|
||||||
* @throws exception_domain if failed to recognize HTTP version
|
* @throws exception_domain if failed to recognize HTTP version
|
||||||
*
|
*
|
||||||
* @var protocol $protocol Version of HTTP protocol
|
* @var protocol $protocol Version of HTTP protocol
|
||||||
@@ -57,12 +56,6 @@ final class response
|
|||||||
public protocol $protocol {
|
public protocol $protocol {
|
||||||
// Write
|
// Write
|
||||||
set (protocol|string $value) {
|
set (protocol|string $value) {
|
||||||
if (isset($this->{__PROPERTY__})) {
|
|
||||||
// The property is already initialized
|
|
||||||
|
|
||||||
// Exit (fail)
|
|
||||||
throw new exception_runtime('The property is already initialized: ' . __PROPERTY__, status::internal_server_error->value);
|
|
||||||
}
|
|
||||||
|
|
||||||
if ($value instanceof protocol) {
|
if ($value instanceof protocol) {
|
||||||
// Received implementation of HTTP version
|
// Received implementation of HTTP version
|
||||||
@@ -95,7 +88,6 @@ final class response
|
|||||||
*
|
*
|
||||||
* @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
|
* @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
|
||||||
*
|
*
|
||||||
* @throws exception_runtime if reinitialize the property
|
|
||||||
* @throws exception_domain if failed to recognize status
|
* @throws exception_domain if failed to recognize status
|
||||||
*
|
*
|
||||||
* @var status $status Status
|
* @var status $status Status
|
||||||
@@ -103,12 +95,6 @@ final class response
|
|||||||
public status $status {
|
public status $status {
|
||||||
// Write
|
// Write
|
||||||
set (status|string $value) {
|
set (status|string $value) {
|
||||||
if (isset($this->{__PROPERTY__})) {
|
|
||||||
// The property is already initialized
|
|
||||||
|
|
||||||
// Exit (fail)
|
|
||||||
throw new exception_runtime('The property is already initialized: ' . __PROPERTY__, status::internal_server_error->value);
|
|
||||||
}
|
|
||||||
|
|
||||||
if ($value instanceof status) {
|
if ($value instanceof status) {
|
||||||
// Received implementation of status
|
// Received implementation of status
|
||||||
@@ -161,10 +147,10 @@ final class response
|
|||||||
set (string $value) {
|
set (string $value) {
|
||||||
// Writing
|
// Writing
|
||||||
$this->body = $value;
|
$this->body = $value;
|
||||||
};
|
}
|
||||||
|
|
||||||
// Read
|
// Read
|
||||||
&get => $this->body;
|
get => $this->body;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -334,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)
|
||||||
@@ -353,12 +339,42 @@ final class response
|
|||||||
*
|
*
|
||||||
* Generates the status line (HTTP/2 200 OK)
|
* Generates the status line (HTTP/2 200 OK)
|
||||||
*
|
*
|
||||||
|
* @param protocol|null $protocol Version of HTTP
|
||||||
|
* @param status|null $status Status code and status text
|
||||||
|
*
|
||||||
* @return string The status line
|
* @return string The status line
|
||||||
*/
|
*/
|
||||||
public function status(): string
|
public function status(?protocol $protocol = null, ?status $status = null): string
|
||||||
{
|
{
|
||||||
|
// Declaring buffer of status line
|
||||||
|
$buffer = '';
|
||||||
|
|
||||||
|
if ($protocol instanceof protocol) {
|
||||||
|
// Received version of HTTP
|
||||||
|
|
||||||
|
// Writing to buffer of status line
|
||||||
|
$buffer .= $protocol->value . ' ';
|
||||||
|
} else {
|
||||||
|
// Not received version of HTTP
|
||||||
|
|
||||||
|
// Writing to buffer of status line
|
||||||
|
$buffer .= $this->protocol->value . ' ';
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($status instanceof status) {
|
||||||
|
// Received status
|
||||||
|
|
||||||
|
// Writing to buffer of status line
|
||||||
|
$buffer .= $status->value . ' ' . $status->label();
|
||||||
|
} else {
|
||||||
|
// Not received status
|
||||||
|
|
||||||
|
// Writing to buffer of status line
|
||||||
|
$buffer .= $this->status->value . ' ' . $this->status->label();
|
||||||
|
}
|
||||||
|
|
||||||
// Exit (success)
|
// Exit (success)
|
||||||
return $this->protocol->value . ' ' . $this->status->value . ' ' . $this->status->label();
|
return $buffer;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -437,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;
|
||||||
|
63
mirzaev/minimal/system/middleware.php
Executable file
63
mirzaev/minimal/system/middleware.php
Executable file
@@ -0,0 +1,63 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
declare(strict_types=1);
|
||||||
|
|
||||||
|
namespace mirzaev\minimal;
|
||||||
|
|
||||||
|
// Files of the project
|
||||||
|
use mirzaev\minimal\http\request,
|
||||||
|
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
|
||||||
|
*
|
||||||
|
* @return string Output
|
||||||
|
*/
|
||||||
|
public function __invoke(callable $next): string
|
||||||
|
{
|
||||||
|
// Processing the middleware (entering into recursion)
|
||||||
|
|
||||||
|
return (string) ($this->function)(next: $next);
|
||||||
|
}
|
||||||
|
}
|
@@ -10,10 +10,10 @@ use mirzaev\minimal\traits\magic;
|
|||||||
/**
|
/**
|
||||||
* Model
|
* Model
|
||||||
*
|
*
|
||||||
* @method void __construct() Constructor
|
|
||||||
*
|
|
||||||
* @package mirzaev\minimal
|
* @package mirzaev\minimal
|
||||||
*
|
*
|
||||||
|
* @method void __construct() Constructor
|
||||||
|
*
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
|
@@ -4,24 +4,33 @@ 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
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal
|
||||||
|
*
|
||||||
* @param string|controller $controller Name of the controller
|
* @param string|controller $controller Name of the controller
|
||||||
* @param string $method Name of the method of the method of $this->controller
|
* @param string $method Name of the method of the method of $this->controller
|
||||||
* @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
|
||||||
* @package mirzaev\minimal
|
|
||||||
*
|
*
|
||||||
* @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,
|
||||||
|
@@ -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;
|
||||||
@@ -15,21 +16,23 @@ use InvalidArgumentException as exception_argument;
|
|||||||
/**
|
/**
|
||||||
* Router
|
* Router
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal
|
||||||
|
*
|
||||||
* @param array $routes Registry of routes
|
* @param array $routes Registry of routes
|
||||||
*
|
*
|
||||||
* @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
|
||||||
* @package mirzaev\minimal
|
* @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
|
||||||
|
@@ -13,13 +13,13 @@ use exception;
|
|||||||
/**
|
/**
|
||||||
* Trait of magical methods
|
* Trait of magical methods
|
||||||
*
|
*
|
||||||
|
* @package mirzaev\minimal\traits
|
||||||
|
*
|
||||||
* @method void __set(string $name, mixed $value) Write property
|
* @method void __set(string $name, mixed $value) Write property
|
||||||
* @method mixed __get(string $name) Read property
|
* @method mixed __get(string $name) Read property
|
||||||
* @method void __unset(string $name) Delete property
|
* @method void __unset(string $name) Delete property
|
||||||
* @method bool __isset(string $name) Check property for initialization
|
* @method bool __isset(string $name) Check property for initialization
|
||||||
*
|
*
|
||||||
* @package mirzaev\minimal\traits
|
|
||||||
*
|
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
|
53
mirzaev/minimal/system/traits/middleware.php
Executable file
53
mirzaev/minimal/system/traits/middleware.php
Executable 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;
|
||||||
|
}
|
||||||
|
}
|
4
mirzaev/minimal/system/traits/singleton.php
Normal file → Executable file
4
mirzaev/minimal/system/traits/singleton.php
Normal file → Executable file
@@ -10,10 +10,10 @@ use exception;
|
|||||||
/**
|
/**
|
||||||
* Trait of singleton
|
* Trait of singleton
|
||||||
*
|
*
|
||||||
* @method static initialize() Initialize an instance
|
|
||||||
*
|
|
||||||
* @package mirzaev\minimal\traits
|
* @package mirzaev\minimal\traits
|
||||||
*
|
*
|
||||||
|
* @method static initialize() Initialize an instance
|
||||||
|
*
|
||||||
* @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>
|
||||||
*/
|
*/
|
||||||
|
Reference in New Issue
Block a user