6 Commits
3.1.0 ... 3.6.2

15 changed files with 194 additions and 112 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)) {
// 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;
@@ -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
try {
// Executing method of the controller and exit (success) // Executing method of the controller and exit (success)
return $route->controller->{$route->method}(...($route->parameters + $request->parameters)); 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

29
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
* *
@@ -91,4 +98,26 @@ enum content: string
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
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.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';
} }

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>
*/ */
@@ -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
@@ -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
@@ -187,7 +187,7 @@ 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
@@ -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
@@ -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
@@ -410,7 +410,7 @@ final class request
unset($buffer); unset($buffer);
} }
if ($this->headers['content-type'] === content::json->value) { if (str_starts_with($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
@@ -441,7 +441,10 @@ final class request
} 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

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

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