something

This commit is contained in:
Arsen Mirzaev Tatyano-Muradovich 2024-11-19 13:03:40 +03:00
parent c92838db5a
commit f936b70916
15 changed files with 137 additions and 59 deletions

0
LICENSE Normal file → Executable file
View File

0
README.md Normal file → Executable file
View File

View File

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

View File

@ -15,6 +15,7 @@ use mirzaev\minimal\router,
// Built-in libraries // Built-in libraries
use exception, use 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 +26,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 +39,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>
*/ */
@ -193,6 +194,9 @@ final class core
// Deinitializing name of the controller class // Deinitializing name of the controller class
unset($controller); unset($controller);
if (!isset($route->controller->model)) {
//
// Initializing name if the model class // Initializing name if the model class
$model = $route->model; $model = $route->model;
@ -219,6 +223,7 @@ final class core
// Writing the model to the controller // Writing the model to the controller
$route->controller->model = $route->model; $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;
@ -226,8 +231,16 @@ 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 $e) {
// Catched an exception
// Exit (fail)
throw new exception_runtime(...$e);
}
} else { } else {
// Not found the method of the controller // Not found the method of the controller

42
mirzaev/minimal/system/http/enumerations/content.php Normal file → Executable file
View 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,7 +64,7 @@ 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';
@ -70,7 +77,7 @@ 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';
@ -78,17 +85,38 @@ enum content: string
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::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
View File

10
mirzaev/minimal/system/http/enumerations/protocol.php Normal file → Executable file
View File

@ -16,9 +16,9 @@ namespace mirzaev\minimal\http\enumerations;
*/ */
enum protocol: string enum protocol: string
{ {
case HTTP_3 = 'HTTP/3'; case http_3 = 'HTTP/3';
case HTTP_2 = 'HTTP/2'; case http_2 = 'HTTP/2';
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';
} }

0
mirzaev/minimal/system/http/enumerations/status.php Normal file → Executable file
View File

View 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>
*/ */

View File

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

View File

@ -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>
*/ */

View File

@ -7,6 +7,8 @@ namespace mirzaev\minimal;
/** /**
* 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
@ -15,8 +17,6 @@ namespace mirzaev\minimal;
* *
* @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) 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>
*/ */

View File

@ -15,6 +15,8 @@ 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)
@ -22,8 +24,6 @@ use InvalidArgumentException as exception_argument;
* @method self sort() Sort routes (DEV) * @method self sort() Sort routes (DEV)
* @method string universalize(string $urn) Universalize URN * @method string universalize(string $urn) Universalize URN
* *
* @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>
*/ */

View File

@ -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>
*/ */

4
mirzaev/minimal/system/traits/singleton.php Normal file → Executable file
View 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>
*/ */