Compare commits
	
		
			9 Commits
		
	
	
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| e93ea5825e | |||
| c841250933 | |||
| beaf55f00b | |||
| 7ae1d6ac70 | |||
| d9e4e0af6c | |||
| d5f4955070 | |||
| 74c3decaa6 | |||
| e9f7cd39b6 | |||
| 476037b062 | 
							
								
								
									
										72
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										72
									
								
								README.md
									
									
									
									
									
								
							@@ -1,14 +1,10 @@
 | 
				
			|||||||
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. **Middlewares** technology
 | 
				
			||||||
 | 
					2. Route sorting `router::sort()`
 | 
				
			||||||
## Nearest plans (first half of 2025)
 | 
					3. Processing routes from within routes (request emulation)
 | 
				
			||||||
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 +12,37 @@ 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
 | 
					## Projects based on MINIMAL
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### ebala
 | 
					### ebala
 | 
				
			||||||
**Repository:** https://git.mirzaev.sexy/mirzaev/ebala<br>
 | 
					**Repository:** https://git.svoboda.works/mirzaev/ebala<br>
 | 
				
			||||||
**Github mirror:** https://github.com/mature-woman/ebala<br>
 | 
					**Github mirror:** https://github.com/mature-woman/ebala<br>
 | 
				
			||||||
*I earned more than a **million rubles** from this project*<br>
 | 
					*I earned more than a **million rubles** from this project*<br>
 | 
				
			||||||
*Repositories **may** be closed at the request of the customer*<br>
 | 
					*Repositories **may** be closed at the request of the customer*<br>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### huesos 
 | 
					### Arming 
 | 
				
			||||||
**Repository:** https://git.mirzaev.sexy/mirzaev/huesos<br>
 | 
					**Repository:** https://git.svoboda.works/weby/arming<br>
 | 
				
			||||||
**Guthub mirror:** https://github.com/mature-woman/huesos<br>
 | 
					**Guthub mirror:** https://github.com/WEBY-GROUP/arming<br>
 | 
				
			||||||
*The basis for developing chat-robots with Web App technology (for example for Telegram)*<br>
 | 
					*Telegram chat-robot marketplace*<br>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### arming_bot 
 | 
					### not.chat
 | 
				
			||||||
**Repository:** https://git.mirzaev.sexy/mirzaev/arming_bot<br>
 | 
					**Repository:** https://git.svoboda.works/mirzaev/notchat<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>
 | 
					**Github mirror:** https://github.com/mature-woman/notchat<br>
 | 
				
			||||||
*P2P chat project with different blockchains and smart stuff*<br>
 | 
					*P2P chat project with 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>
 | 
					 | 
				
			||||||
 
 | 
				
			|||||||
@@ -195,7 +195,7 @@ final class core
 | 
				
			|||||||
		unset($controller);
 | 
							unset($controller);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
		if (!isset($route->controller->model)) {
 | 
							if (!isset($route->controller->model)) {
 | 
				
			||||||
		//
 | 
								// Not initialized the model in the controller
 | 
				
			||||||
 | 
					
 | 
				
			||||||
			// Initializing name if the model class
 | 
								// Initializing name if the model class
 | 
				
			||||||
			$model = $route->model;
 | 
								$model = $route->model;
 | 
				
			||||||
@@ -234,11 +234,11 @@ final class core
 | 
				
			|||||||
			try {
 | 
								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 $e) {
 | 
								} catch (exception $exception) {
 | 
				
			||||||
				// Catched an exception
 | 
									// Catched an exception
 | 
				
			||||||
 | 
					
 | 
				
			||||||
				// Exit (fail)
 | 
									// Exit (fail)
 | 
				
			||||||
				throw new exception_runtime(...$e);
 | 
									throw new exception_runtime('Caught an error while processing the route', status::internal_server_error->value, $exception);
 | 
				
			||||||
			}
 | 
								}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
		} else {
 | 
							} else {
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -115,6 +115,7 @@ enum content: string
 | 
				
			|||||||
		return match ($this) {
 | 
							return match ($this) {
 | 
				
			||||||
			self::jpeg => 'jpg',
 | 
								self::jpeg => 'jpg',
 | 
				
			||||||
			self::png => 'png',
 | 
								self::png => 'png',
 | 
				
			||||||
 | 
								self::webp => 'webp',
 | 
				
			||||||
			self::form, self::mixed, self::alternative, self::related => throw new exception_argument('Content can not have file extension', status::internal_server_error->value),
 | 
								self::form, self::mixed, self::alternative, self::related => throw new exception_argument('Content can not have file extension', status::internal_server_error->value),
 | 
				
			||||||
			default => throw new exception_domain('Failed to recognize content: ' . $this->value, status::not_found->value)
 | 
								default => throw new exception_domain('Failed to recognize content: ' . $this->value, status::not_found->value)
 | 
				
			||||||
		};
 | 
							};
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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 = 'hTTP/1.0';
 | 
						case http_1 = 'HTTP/1.0';
 | 
				
			||||||
	case http_0_9 = 'HTTP/0.9';
 | 
						case http_0_9 = 'HTTP/0.9';
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -324,13 +324,16 @@ 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)) {
 | 
							if (isset($headers)) {
 | 
				
			||||||
			// Received headers
 | 
								// Received headers
 | 
				
			||||||
@@ -363,10 +366,12 @@ final class request
 | 
				
			|||||||
		}
 | 
							}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
		// 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
 | 
				
			||||||
@@ -410,7 +415,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 +446,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
 | 
				
			||||||
@@ -464,8 +472,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);
 | 
				
			||||||
	}
 | 
						}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	/**
 | 
						/**
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -320,7 +320,7 @@ final class response
 | 
				
			|||||||
	 */
 | 
						 */
 | 
				
			||||||
	public function validate(request $request): self|false
 | 
						public function validate(request $request): self|false
 | 
				
			||||||
	{
 | 
						{
 | 
				
			||||||
		if (str_contains($request->headers['accept'], $this->headers['content-type'] ?? '')) {
 | 
							if (str_contains($request->headers['accept'] ?? '', $this->headers['content-type'] ?? '')) {
 | 
				
			||||||
			// Validated with "accept" and "content-type"
 | 
								// Validated with "accept" and "content-type"
 | 
				
			||||||
	
 | 
						
 | 
				
			||||||
			// Exit (success)
 | 
								// Exit (success)
 | 
				
			||||||
@@ -453,10 +453,10 @@ final class response
 | 
				
			|||||||
		flush();
 | 
							flush();
 | 
				
			||||||
 | 
					
 | 
				
			||||||
		// Deinitializing headers property
 | 
							// Deinitializing headers property
 | 
				
			||||||
		unset($this->headers);
 | 
							$this->headers = [];
 | 
				
			||||||
	
 | 
						
 | 
				
			||||||
		// Deinitializing headers
 | 
							// Deinitializing headers
 | 
				
			||||||
		header_remove();
 | 
							/* header_remove(); */
 | 
				
			||||||
		
 | 
							
 | 
				
			||||||
		// Exit (success)
 | 
							// Exit (success)
 | 
				
			||||||
		return $this;
 | 
							return $this;
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user