beauty

LICENSE

@@ -0,0 +1,11 @@
+DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+Version 2, December 2004
+
+Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.
+
+DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

README.md

@@ -0,0 +1,54 @@
+🤟 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**
+
+Can be configured to work with **any database** (`core::$session`) and **any HTML template engine** (`$this->view`) 
+*personally, i prefer **ArangoDB** and **Twig***
+
+## 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 
+Execute: `composer require mirzaev/minimal`
+
+## Usage
+*index.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
+$core = new core(namespace: __NAMESPACE__, router: $router, controller: new controller(false), model: new model(false));
+
+// Handle the request
+echo $core->start();
+```
+
+## Examples of projects based on MINIMAL
+
+### ebala (⚠️VERY HUGE)
+Repository: https://git.mirzaev.sexy/mirzaev/ebala
+Github mirror: https://github.com/mature-woman/ebala
+**I earned more than a million rubles from this project**
+**Repositories *may* be closed at the request of the customer**
+
+### notchat
+Repository: https://git.mirzaev.sexy/mirzaev/notchat
+Github mirror: https://github.com/mature-woman/notchat
+**P2P chat project with different blockchains and smart stuff**
+
+### site-repression
+Link: https://repression.mirzaev.sexy
+Repository: https://git.mirzaev.sexy/mirzaev/site-repression
+Github mirror: https://github.com/mature-woman/site-repression
+**A simple site for my article about *political repressions in Russia* and my *abduction by Wagner PMC operatives* from my home**

composer.json

@@ -4,7 +4,8 @@
     "description": "Lightweight MVC framework that manages only the basic mechanisms, leaving the development of the programmer and not overloading the project",
     "keywords": [
         "mvc",
-        "framework"
+        "framework",
+        "lightweight"
     ],
     "license": "WTFPL",
     "homepage": "https://git.mirzaev.sexy/mirzaev/minimal",
@@ -21,10 +22,7 @@
         "issues": "https://git.mirzaev.sexy/mirzaev/minimal/issues"
     },
     "require": {
-        "php": "~8.1"
-    },
-    "suggest": {
-        "ext-PDO": "To work with SQL-based databases (MySQL, PostreSQL...)"
+        "php": "~8.2"
     },
     "autoload": {
         "psr-4": {

mirzaev/minimal/system/controller.php

@@ -4,178 +4,91 @@ declare(strict_types=1);
 
 namespace mirzaev\minimal;
 
-// Файлы проекта
-use mirzaev\minimal\model;
+// Files of the project
+use mirzaev\minimal\model,
+	mirzaev\minimal\traits\magic;
 
 // Встроенные библиотеки
 use exception;
 
 /**
- * Контроллер
+ * Controller (base)
  *
  * @package mirzaev\minimal
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 class controller
 {
-    /**
-     * Постфикс
-     */
-    private string $postfix = '_controller';
+	use magic;
 
 	/**
-     * Модель
+	 * Postfix of file names
+	 */
+	public const string POSTFIX = '_controller';
+
+	/**
+	 * Instance of the model connected in the router
 	 */
 	protected model $model;
 
 	/**
-     * Шаблонизатор представления
+	 * View template engine instance (twig)
 	 */
 	protected object $view;
 
 	/**
-     * Конструктор
-     *
-     * @return void
+	 * Constructor
 	 */
-    public function __construct()
-    {
-    }
+	public function __construct() {}
 
 	/**
-     * Записать свойство
+	 * Write property
 	 *
-     * @param string $name Название
-     * @param mixed $value Значение
+	 * @param string $name Name of the property
+	 * @param mixed $value Value of the property
+	 *
+	 * @return void
 	 */
 	public function __set(string $name, mixed $value = null): void
 	{
 		match ($name) {
 			'model' => (function () use ($value) {
-                if ($this->__isset('model')) {
-                    // Свойство уже было инициализировано
+				if ($this->__isset('model')) throw new exception('Can not reinitialize property: ' . static::class . '::$model', 500);
+				else {
+					// Property not initialized 
 
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать модель ($this->model)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if ($value instanceof model) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->model = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Модель ($this->model) должна хранить инстанцию "mirzaev\minimal\model"', 500);
-                    }
+					if (is_object($value)) $this->model = $value;
+					else throw new exception('Property "' . static::class . '::view" should store an instance of a model', 500);
 				}
 			})(),
 			'view' => (function () use ($value) {
-                if ($this->__isset('view')) {
-                    // Свойство уже было инициализировано
+				if ($this->__isset('view')) throw new exception('Can not reinitialize property: ' . static::class . '::$view', 500);
+				else {
+					// Property not initialized 
 
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать шаблонизатор представления ($this->view)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if (is_object($value)) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->view = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Шаблонизатор представлений ($this->view) должен хранить объект', 500);
-                    }
+					if (is_object($value)) $this->view = $value;
+					else throw new exception('Property "' . static::class . '::view" should store an instance of a view template engine', 500);
 				}
 			})(),
-            'postfix' => (function () use ($value) {
-                if ($this->__isset('postfix')) {
-                    // Свойство уже было инициализировано
-
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать постфикс ($this->postfix)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if ($value = filter_var($value, FILTER_SANITIZE_STRING)) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->postfix = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Постфикс ($this->postfix) должен быть строкой', 500);
-                    }
-                }
-            })(),
-            default => throw new exception("Свойство \"\$$name\" не найдено", 404)
+			default => throw new exception('Property "' . static::class . "::\$$name\" not found", 404)
 		};
 	}
 
 	/**
-     * Прочитать свойство
+	 * Read property
 	 *
-     * Записывает значение по умолчанию, если свойство не инициализировано
+	 * @param string $name Name of the property
 	 *
-     * @param string $name Название
-     *
-     * @return mixed Содержимое
+	 * @return mixed Value of the property
 	 */
 	public function __get(string $name): mixed
 	{
 		return match ($name) {
-            'postfix' => (function () {
-                if ($this->__isset('postfix')) {
-                    // Свойство уже было инициализировано
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    // Инициализация со значением по умолчанию
-                    $this->__set('postfix', '_controller');
-                }
-
-                // Возврат (успех)
-                return $this->postfix;
-            })(),
-            'view' => $this->view ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
-            'model' => $this->model ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
-            default => throw new exception("Свойство \"\$$name\" не обнаружено", 404)
-        };
-    }
-
-    /**
-     * Проверить свойство на инициализированность
-     *
-     * @param string $name Название
-     */
-    public function __isset(string $name): bool
-    {
-        return match ($name) {
-            default => isset($this->{$name})
-        };
-    }
-
-    /**
-     * Удалить свойство
-     *
-     * @param string $name Название
-     */
-    public function __unset(string $name): void
-    {
-        match ($name) {
-            default => (function () use ($name) {
-                // Удаление
-                unset($this->{$name});
-            })()
+			'model' => $this->model ?? throw new exception('Property "' . static::class . '::$model" is not initialized', 500),
+			'view' => $this->view ?? throw new exception('Property "' . static::class . '::$view" is not initialized', 500),
+			default => throw new exception('Property "' . static::class . "::\$$name\" not found", 404)
 		};
 	}
 }

mirzaev/minimal/system/core.php

@@ -10,100 +10,86 @@ use mirzaev\minimal\router,
 	mirzaev\minimal\model;
 
 // Встроенные библиотеки
-use exception;
+use exception,
+	ReflectionClass as reflection;
 
 /**
- * Ядро
+ * Core
  *
  * @package mirzaev\minimal
- * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
- * @todo
- * 1. Добавить __isset() и __unset()
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class core
 {
 	/**
-     * Соединение с базой данных
+	 * Инстанция соединения с базой данных
 	 */
-    private object $storage;
+	private object $db;
 
 	/**
-     * Маршрутизатор
+	 * Инстанция маршрутизатора
 	 */
-    private router $router;
+	private readonly router $router;
 
 	/**
-     * Контроллер
+	 * Инстанция ядра контроллера
 	 */
-    private controller $controller;
+	private readonly controller $controller;
 
 	/**
-     * Модель
+	 * Инстанция ядра модели
 	 */
-    private model $model;
+	private readonly model $model;
 
 	/**
-     * Пространство имён проекта
+	 * Путь пространства имён (системное)
 	 *
 	 * Используется для поиска файлов по спецификации PSR-4
 	 */
-    private string $namespace;
+	private readonly string $namespace;
 
 	/**
 	 * Конструктор
 	 *
-     * @param object $storage Хранилище
-     * @param router $router Маршрутизатор
-     * @param string $uri Маршрут
+	 * @param ?object $db Инстанция соединения с базой данных
+	 * @param ?router $router Маршрутизатор
+	 * @param ?controller $controller Инстанция ядра контроллера
+	 * @param ?model $model Инстанция ядра модели
+	 * @param ?string $namespace Пространство имён системного ядра
+	 * 
+	 * @return self Инстанция ядра
 	 */
-    public function __construct(object $storage = null, router $router = null, controller $controller = null, model $model = null, string $namespace = null)
-    {
-        if (isset($storage)) {
-            // Переданы данные для хранилища
-
-            // Проверка и запись
-            $this->__set('storage', $storage);
-        }
-
-        if (isset($router)) {
-            // Переданы данные для маршрутизатора
-
-            // Проверка и запись
-            $this->__set('router', $router);
-        }
-
-        if (isset($controller)) {
-            // Переданы данные для контроллера
-
-            // Проверка и запись
-            $this->__set('controller', $controller);
-        }
-
-        if (isset($model)) {
-            // Переданы данные для модели
-
-            // Проверка и запись
-            $this->__set('model', $model);
-        }
-
-        if (isset($namespace)) {
-            // Переданы данные для пространства имён
-
-            // Проверка и запись
-            $this->__set('namespace', $namespace);
-        }
+	public function __construct(
+		?object $db = null,
+		?router $router = null,
+		?controller $controller = null,
+		?model $model = null,
+		?string $namespace = null
+	) {
+		// Инициализация свойств
+		if (isset($db)) $this->__set('db', $db);
+		if (isset($router)) $this->__set('router', $router);
+		if (isset($controller)) $this->__set('controller', $controller);
+		if (isset($model)) $this->__set('model', $model);
+		$this->__set('namespace', $namespace ?? (new reflection(self::class))->getNamespaceName());
 	}
 
 	/**
 	 * Деструктор
 	 *
 	 */
-    public function __destruct()
-    {
-    }
+	public function __destruct() {}
 
-    public function start(string $uri = null): ?string
+	/**
+	 * Запуск
+	 *
+	 * @param ?string $uri Маршрут
+	 *
+	 * @return string|int|null Ответ
+	 */
+	public function start(string $uri = null): string|int|null
 	{
 		// Обработка запроса
 		return $this->__get('router')->handle($uri, core: $this);
@@ -113,119 +99,56 @@ final class core
 	 * Записать свойство
 	 *
 	 * @param string $name Название
-     * @param mixed $value Значение
+	 * @param mixed $value Содержимое
+	 *
+	 * @return void
 	 */
 	public function __set(string $name, mixed $value = null): void
 	{
 		match ($name) {
-            'storage', 'db', 'database' => (function () use ($value) {
-                if ($this->__isset('storage')) {
-                    // Свойство уже было инициализировано
-
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать хранилище ($this->storage)', 500);
-                } else {
+			'db', 'database' => (function () use ($value) {
+				if ($this->__isset('db')) throw new exception('Запрещено реинициализировать инстанцию соединения с базой данных ($this->db)', 500);
+				else {
 					// Свойство ещё не было инициализировано
 
-                    if (is_object($value)) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->storage = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Хранилище ($this->storage) должно хранить объект', 500);
-                    }
+					if (is_object($value)) $this->db = $value;
+					else throw new exception('Свойство $this->db должно хранить инстанцию соединения с базой данных', 500);
 				}
 			})(),
 			'router' => (function () use ($value) {
-                if ($this->__isset('router')) {
-                    // Свойство уже было инициализировано
-
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать маршрутизатор ($this->router)', 500);
-                } else {
+				if ($this->__isset('router')) throw new exception('Запрещено реинициализировать инстанцию маршрутизатора ($this->router)', 500);
+				else {
 					// Свойство ещё не было инициализировано
 
-                    if ($value instanceof router) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->router = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Маршрутизатор ($this->router) должен хранить инстанцию "mirzaev\minimal\router"', 500);
-                    }
+					if ($value instanceof router) $this->router = $value;
+					else throw new exception('Свойство $this->router должно хранить инстанцию маршрутизатора (mirzaev\minimal\router)"', 500);
 				}
 			})(),
 			'controller' => (function () use ($value) {
-                if ($this->__isset('controller')) {
-                    // Свойство уже было инициализировано
+				if ($this->__isset('controller')) throw new exception('Запрещено реинициализировать инстанцию ядра контроллеров ($this->controller)', 500);
+				else {
+					// Свойство не инициализировано
 
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать контроллер ($this->controller)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if ($value instanceof controller) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->controller = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Контроллер ($this->controller) должен хранить инстанцию "mirzaev\minimal\controller"', 500);
-                    }
+					if ($value instanceof controller) $this->controller = $value;
+					else throw new exception('Свойство $this->controller должно хранить инстанцию ядра контроллеров (mirzaev\minimal\controller)', 500);
 				}
 			})(),
 			'model' => (function () use ($value) {
-                if ($this->__isset('model')) {
-                    // Свойство уже было инициализировано
+				if ($this->__isset('model')) throw new exception('Запрещено реинициализировать инстанцию ядра моделей ($this->model)', 500);
+				else {
+					// Свойство не инициализировано
 
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать модель ($this->model)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if ($value instanceof model) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->model = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Модель ($this->model) должен хранить инстанцию "mirzaev\minimal\model"', 500);
-                    }
+					if ($value instanceof model) $this->model = $value;
+					else throw new exception('Свойство $this->model должно хранить инстанцию ядра моделей (mirzaev\minimal\model)', 500);
 				}
 			})(),
 			'namespace' => (function () use ($value) {
-                if ($this->__isset('namespace')) {
-                    // Свойство уже было инициализировано
+				if ($this->__isset('namespace')) throw new exception('Запрещено реинициализировать путь пространства имён ($this->namespace)', 500);
+				else {
+					// Свойство не инициализировано
 
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать пространство имён ($this->namespace)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if (is_string($value)) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->namespace = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Пространство имён ($this->namespace) должно хранить строку', 500);
-                    }
+					if (is_string($value)) $this->namespace = $value;
+					else throw new exception('Свойство $this->namespace должно хранить строку с путём пространства имён', 500);
 				}
 			})(),
 			default => throw new exception("Свойство \"\$$name\" не найдено", 404)
@@ -244,42 +167,24 @@ final class core
 	public function __get(string $name): mixed
 	{
 		return match ($name) {
-            'storage', 'db', 'database' => $this->storage ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
+			'db', 'database' => $this->db ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
 			'router' => (function () {
-                if ($this->__isset('router')) {
-                    // Свойство уже было инициализировано
-                } else {
-                    // Свойство ещё не было инициализировано
-
 				// Инициализация со значением по умолчанию
-                    $this->__set('router', new router);
-                }
+				if (!$this->__isset('router')) $this->__set('router', new router);
 
 				// Возврат (успех)
 				return $this->router;
 			})(),
 			'controller' => (function () {
-                if ($this->__isset('controller')) {
-                    // Свойство уже было инициализировано
-                } else {
-                    // Свойство ещё не было инициализировано
-
 				// Инициализация со значением по умолчанию
-                    $this->__set('controller', new controller);
-                }
+				if (!$this->__isset('controller')) $this->__set('controller', new controller);
 
 				// Возврат (успех)
 				return $this->controller;
 			})(),
 			'model' => (function () {
-                if ($this->__isset('model')) {
-                    // Свойство уже было инициализировано
-                } else {
-                    // Свойство ещё не было инициализировано
-
 				// Инициализация со значением по умолчанию
-                    $this->__set('model', new model);
-                }
+				if (!$this->__isset('model')) $this->__set('model', new model);
 
 				// Возврат (успех)
 				return $this->model;
@@ -293,6 +198,8 @@ final class core
 	 * Проверить свойство на инициализированность
 	 *
 	 * @param string $name Название
+	 *
+	 * @return bool Инициализировано свойство?
 	 */
 	public function __isset(string $name): bool
 	{
@@ -305,6 +212,8 @@ final class core
 	 * Удалить свойство
 	 *
 	 * @param string $name Название
+	 *
+	 * @return void
 	 */
 	public function __unset(string $name): void
 	{

mirzaev/minimal/system/model.php

@@ -4,110 +4,31 @@ declare(strict_types=1);
 
 namespace mirzaev\minimal;
 
-// Встроенные библиотеки
+// Files of the project
+use	mirzaev\minimal\traits\magic;
+
+// Built-in libraries
 use exception;
 
 /**
- * Модель
+ * Model (base)
  *
  * @package mirzaev\minimal
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 class model
 {
-    /**
-     * Постфикс
-     */
-    private string $postfix = '_model';
+	use magic;
 
 	/**
-     * Записать свойство
-     *
-     * @param string $name Название
-     * @param mixed $value Значение
+	 * Postfix of file names
 	 */
-    public function __set(string $name, mixed $value = null): void
-    {
-        match ($name) {
-            'postfix' => (function () use ($value) {
-                if (isset($this->postfix)) {
-                    // Свойство уже было инициализировано
-
-                    // Выброс исключения (неудача)
-                    throw new exception('Запрещено реинициализировать постфикс ($this->postfix)', 500);
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    if ($value = filter_var($value, FILTER_SANITIZE_STRING)) {
-                        // Передано подходящее значение
-
-                        // Запись свойства (успех)
-                        $this->postfix = $value;
-                    } else {
-                        // Передано неподходящее значение
-
-                        // Выброс исключения (неудача)
-                        throw new exception('Постфикс ($this->postfix) должен быть строкой', 500);
-                    }
-                }
-            })(),
-            default => throw new exception("Свойство \"\$$name\" не найдено", 404)
-        };
-    }
+	public const string POSTFIX = '_model';
 
 	/**
-     * Прочитать свойство
-     *
-     * Записывает значение по умолчанию, если свойство не инициализировано
-     *
-     * @param string $name Название
-     *
-     * @return mixed Содержимое
+	 * Constructor
 	 */
-    public function __get(string $name): mixed
-    {
-        return match ($name) {
-            'postfix' => (function() {
-                if ($this->__isset('postfix')) {
-                    // Свойство уже было инициализировано
-                } else {
-                    // Свойство ещё не было инициализировано
-
-                    // Инициализация со значением по умолчанию
-                    $this->__set('postfix', '_model');
-                }
-
-                // Возврат (успех)
-                return $this->postfix;
-            })(),
-            default => throw new exception("Свойство \"\$$name\" не обнаружено", 404)
-        };
-    }
-
-    /**
-     * Проверить свойство на инициализированность
-     *
-     * @param string $name Название
-     */
-    public function __isset(string $name): bool
-    {
-        return match ($name) {
-            default => isset($this->{$name})
-        };
-    }
-
-    /**
-     * Удалить свойство
-     *
-     * @param string $name Название
-     */
-    public function __unset(string $name): void
-    {
-        match ($name) {
-            default => (function () use ($name) {
-                // Удаление
-                unset($this->{$name});
-            })()
-        };
-    }
+	public function __construct() {}
 }

mirzaev/minimal/system/router.php

@@ -7,202 +7,312 @@ namespace mirzaev\minimal;
 // Файлы проекта
 use mirzaev\minimal\core;
 
-// Встроенные библиотеки
-use ReflectionClass;
-
 /**
  * Маршрутизатор
  *
- * @package mirzaev\shop
- * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ * @package mirzaev\minimal
  *
- * @todo
- * 1. Доработать обработку ошибок
- * 2. Добавить __set(), __get(), __isset() и __unset()
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class router
 {
 	/**
-     * @var array $router Маршруты
+	 * @var array $router Реестр маршрутов
 	 */
+	/* protected array $routes = []; */
 	public array $routes = [];
 
 	/**
 	 * Записать маршрут
 	 *
 	 * @param string $route Маршрут
-     * @param string $target Обработчик (контроллер и модель, без постфиксов)
-     * @param string|null $method Метод
-     * @param string|null $type Тип
-     * @param string|null $model Модель
+	 * @param string $handler Обработчик - инстанции контроллера и модели (не обязательно), без постфиксов
+	 * @param ?string $method Вызываемый метод в инстанции контроллера обработчика
+	 * @param ?string $request HTTP-метод запроса (GET, POST, PUT...)
+	 * @param ?string $model Инстанция модели (переопределение инстанции модели в $target)
+	 * @param array $variables 
+	 *
+	 * @return static The instance from which the method was called (fluent interface)
 	 */
-    public function write(string $route, string $target, string $method = null, string $type = 'GET', string $model = null): void
-    {
+	public function write(
+		string $route,
+		string $handler,
+		?string $method = 'index',
+		?string $request = 'GET',
+		?string $model = null,
+		array $variables = []
+	): static {
 		// Запись в реестр
-        $this->routes[$route][$type] = [
-            'target' => $target,
-            'method' => $method ?? '__construct'
+		$this->routes[$route][$request] = [
+			'controller' => $handler,
+			'model' => $model ?? $handler,
+			'method' => $method,
+			'variables' => $variables
 		];
+
+		// Exit (success) (fluent interface)
+		return $this;
 	}
 
 	/**
-     * Обработать маршрут
+	 * Handle a request
 	 *
-     * @param string $route Маршрут
+	 * @param string|null $uri URI (protocol://domain/foo/bar)
+	 * @param string|null $method Method (GET, POST, PUT...)
+	 * @param core|null $core Instence of the system core
+	 *
+	 * @return string|int|null Response
 	 */
-    public function handle(string $uri = null, core $core = null): ?string
-    {
-        // Запись полученного URI или из данных веб-сервера
-        $uri = $uri ?? $_SERVER['REQUEST_URI'] ?? '';
-
-        // Инициализация URL
-        $url = parse_url($uri, PHP_URL_PATH);
-
-        // Универсализация
-        $url = self::universalization($url);
-
-        // Сортировка массива маршрутов от большего ключа к меньшему (кешируется)
-        krsort($this->routes);
-
-        // Поиск директорий в ссылке
-        preg_match_all('/[^\/]+/', $url, $directories);
-
-        // Инициализация директорий
-        $directories = $directories[0];
+	public function handle(
+		?string $uri = null,
+		?string $method = null,
+		?core $core = new core
+	): string|int|null {
+		// Declaration of the registry of routes directoies 
+		$routes = [];
 
 		foreach ($this->routes as $route => $data) {
-            // Перебор маршрутов
+			// Iteration over routes
 
-            // Универсализация
-            $route = self::universalization($route);
+			// Search directories of route (explode() creates empty value in array)
+			preg_match_all('/(^\/$|[^\/]+)/', $route, $data['directories']);
+			$routes[$route] = $data['directories'][0];
+		}
 
-            // Поиск директорий в маршруте
-            preg_match_all('/[^\/]+/', $route, $data['directories']);
+		if (count($routes) === count($this->routes)) {
+			// Initialized the registry of routes directoies 
 
-            // Инициализация директорий
-            $data['directories'] = $data['directories'][0];
+			// Initializing default values		
+			$uri ??= $_SERVER['REQUEST_URI'] ?? '/';
+			$method ??= $_SERVER["REQUEST_METHOD"];
 
-            if (count($directories) === count($data['directories'])) {
-                // Совпадает количество директорий у ссылки и маршрута (вероятно эта ссылка на этот маршрут)
+			// Initializing of URN (/foo/bar)
+			$urn = parse_url(urldecode($uri), PHP_URL_PATH);
 
-                // Инициализация массива переменных
-                $data['vars'] = [];
+			// Universalization of URN
+			$urn = self::universalize($urn);
 
-                foreach ($data['directories'] as $index => &$directory) {
-                    // Перебор найденных переменных
+			// Search directories of URN (explode() creates empty value in array)
+			preg_match_all('/(^\/$|[^\/]+)/', $urn, $directories);
+			$directories = $directories[0];
 
-                    if (preg_match('/\$([a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]+)/', $directory) === 1) {
-                        // Переменная
+			/**
+			 * Initialization of the route
+			 */
 
-                        // Запись в массив переменных и перезапись переменной значением из ссылки
-                        $directory = $data['vars'][trim($directory, '$')] = $directories[$index];
+			// Initializing the buffer of matches of route directories with URN directories
+			$matches = [];
+
+			foreach ($directories as $i => $urn_directory) {
+				// Iteration over directories of URN 
+
+				foreach ($this->routes as $route => $data) {
+					// Iteration over routes
+
+					if (isset($data[$method])) {
+						// The request method matches the route method
+
+						// Universalization of route
+						$route = self::universalize($route);
+
+						// Skipping unmatched routes based on results of previous iterations
+						if (isset($matches[$route]) && $matches[$route] === false) continue;
+
+						// Initializing of route directory
+						$route_directory = $routes[$route][$i] ?? null;
+
+						if (isset($route_directory)) {
+							// Initialized of route directory
+
+							if ($urn_directory === $route_directory) {
+								// The directory of URN is identical to the directory of route
+
+								// Writing: end of URN directories XNOR end of route directories
+								$matches[$route] = !(isset($directories[$_i = $i + 1]) xor isset($routes[$route][$_i]));
+							} else if (preg_match('/^\$([a-zA-Z_\x80-\xff]+)$/', $route_directory) === 1) {
+								// The directory of route is a variable ($variable)
+
+								// Writing: end of URN directories XNOR end of route directories
+								$matches[$route] = !(isset($directories[$_i = $i + 1]) xor isset($routes[$route][$_i]));
+							} else if (
+								!isset($routes[$route][$i + 1])
+								&& preg_match('/^\$([a-zA-Z_\x80-\xff]+\.\.\.)$/', $route_directory) === 1
+							) {
+								// The directory of route is a collector ($variable...)
+								// AND this is the end of route directories
+
+								// Writing
+								$matches[$route] = 'collector';
+							} else $matches[$route] = false;
+						} else if ($matches[$route] === 'collector') {
+						} else $matches[$route] = false;
+					}
 				}
 			}
 
-                // Реиницилазция маршрута
-                $route = self::universalization(implode('/', $data['directories']));
+			// Finding a priority route from match results
+			foreach ($matches as $route => $match) if ($match !== false) break;
 
-                // Маршрут оказался пустым
-                if (empty($route)) $route = '/';
+			if ($route && !empty($data = $this->routes[$route])) {
+				// Route found
 
-                if (mb_stripos($route, $url, 0, "UTF-8") === 0 && mb_strlen($route, 'UTF-8') <=  mb_strlen($url, 'UTF-8')) {
-                    // Найден маршрут, а так же его длина не меньше длины запрошенного URL
+				// Universalization of route
+				$route = self::universalize($route);
 
-                    // Инициализация маршрута
-                    if (array_key_exists($_SERVER["REQUEST_METHOD"], $data)) {
-                        // Найдены настройки для полученного типа запроса
+				/**
+				 * Initialization of route variables
+				 */
 
-                        // Запись маршрута
-                        $route = $data[$_SERVER["REQUEST_METHOD"]];
-                    } else {
-                        // Не найдены настройки для полученного типа запроса
+				foreach ($routes[$route] as $i => $route_directory) {
+					// Iteration over directories of route
 
-                        // Деинициализация
-                        unset($route);
+					if (preg_match('/^\$([a-zA-Z_\x80-\xff]+)$/', $route_directory) === 1) {
+						// The directory is a variable ($variable)
+
+						// Запись в реестр переменных и перещапись директории в маршруте
+						$data[$method]['variables'][trim($route_directory, '$')] = $directories[$i];
+					} else if (preg_match('/^\$([a-zA-Z_\x80-\xff]+\.\.\.)$/', $route_directory) === 1) {
+						// The directory of route is a collector ($variable...)
+
+						// Инициализаия ссылки на массив сборщика
+						$collector = &$data[$method]['variables'][trim($route_directory, '$.')];
+
+						// Инициализаия массива сборщика
+						$collector ??= [];
+
+						// Запись в реестр переменных
+						$collector[] = $directories[$i];
+
+						foreach (array_slice($directories, ++$i, preserve_keys: true) as &$urn_directory) {
+							// Перебор директорий URN
+
+							// Запись в реестр переменных
+							$collector[] = $urn_directory;
 						}
 
-                    // Выход из цикла
 						break;
 					}
 				}
 
-            // Деинициализация
-            unset($route);
-        }
+				/**
+				 * Initialization of route handlers
+				 */
 
-        if (!empty($route)) {
-            // Найден маршрут
+				if (array_key_exists($method, $data)) {
+					// Идентифицирован метод маршрута (GET, POST, PUT...)
 
-            if (class_exists($controller = ($core->namespace ?? (new core)->namespace) . '\\controllers\\' . $route['target'] . $core->controller->postfix ?? (new core())->controller->postfix)) {
+					// Инициализация обработчиков (controller, model, method)
+					$handlers = $data[$method];
+
+					if (class_exists($controller = $core->namespace . '\\controllers\\' . $handlers['controller'] . $core->controller::POSTFIX)) {
 						// Найден контроллер
 
-                // Инициализация контроллера
+						// Инициализация инстанции ядра контроллера
 						$controller = new $controller;
 
-                if (class_exists($model = ($core->namespace ?? (new core)->namespace) . '\\models\\' . $route['target'] . $core->model->postfix ?? (new core())->model->postfix)) {
-                    // Найдена модель
-
-                    // Инициализация модели
-                    $controller->model = new $model;
+						// Вызов связанного с маршрутом метода и возврат (успех)
+						return $controller->{$handlers['method']}($handlers['variables'] + $_REQUEST, $_FILES, file_get_contents('php://input'));
 					}
-
-                if (empty($response = $controller->{$route['method']}($data['vars'] + $_REQUEST, $_FILES))) {
-                    // Не удалось получить ответ после обработки контроллера
-
-                    // Возврат (неудача)
-                    return $this->error($core);
 				}
-
-                // Возврат (успех)
-                return $response;
 			}
 		}
 
-        // Возврат (неудача)
+		// Возврат (провал)
 		return $this->error($core);
 	}
 
 	/**
-     * Контроллер ошибок
+	 * Sorting routes
 	 *
-     * @param core $core Ядро фреймворка
+	 * 1. Short routes
+	 * 2. Long routes
+	 * 3. Short routes with variables (position of variables from "right" to "left")
+	 * 4. Long routes with variables (position of variables from "right" to "left")
+	 * 5. Short routes with collector
+	 * 6. Long routes with collector
+	 * 7. Short routes with variables and collector (position of variables from "right" to "left" then by amount)
+	 * 8. Long routes with variables and collector (position of variables from "right" to "left")
 	 *
-     * @return string|null HTML-документ с ошибкой
+	 * Добавить чтобы сначала текст потом переменная затем после переменной первыми тексты и в конце перменные опять и так рекурсивно
+	 *
+	 * @return static The instance from which the method was called (fluent interface)
+   *
+	 * @todo ПЕРЕДЕЛАТЬ ПОЛНОСТЬЮ
 	 */
-    private function error(core $core = null): ?string
+	public function sort(): static
 	{
-        if (
-            class_exists($class = '\\' . ($core->namespace ?? (new ReflectionClass(core::class))->getNamespaceName()) . '\\controllers\\errors' . $core->controller->postfix ?? (new core())->controller->postfix) &&
-            method_exists($class, $method = 'error404')
-        ) {
-            // Существует контроллер ошибок и метод для обработки ошибки
+		uksort($this->routes, function (string $a, string $b) {
+			// Sorting routes
 
-            // Возврат (вызов метода для обработки ошибки)
-            return (new $class(basename($class)))->$method();
-        } else {
-            // Не существует контроллер ошибок или метод для обработки ошибки
+			// Initialization of string lengths (multibyte-safe)
+			$length = [
+				$a => mb_strlen($a),
+				$b => mb_strlen($b)
+			];
 
-            // Никаких исключений не вызывать, отдать пустую страницу,
-            // либо вызвать, но отображать в зависимости от включенного дебаг режима !!!!!!!!!!!!!!!!!!!! см. @todo
-            return null;
+			// Initialization of the presence of variables
+			$variables = [
+				$a => preg_match('/\$([a-zA-Z_\x80-\xff]+)(\/|$)/', $a) === 1,
+				$b => preg_match('/\$([a-zA-Z_\x80-\xff]+)(\/|$)/', $b) === 1
+			];
+
+			// Initialization of the presence of collectors
+			$collectors = [
+				$a => preg_match('/\$([a-zA-Z_\x80-\xff]+)\.\.\.$/', $a) === 1,
+				$b => preg_match('/\$([a-zA-Z_\x80-\xff]+)\.\.\.$/', $b) === 1
+			];
+
+
+			if ($variables[$a] && !$variables[$b]) return 1;
+			else if (!$variables[$a] && $variables[$b]) return -1;
+			else if ($variables[$a] && $variables[$b]) {
+			} else if ($collectors[$a] && !$collectors[$b]) return 1;
+			else if (!$collectors[$a] && $collectors[$b]) return -1;
+			else {
+				// NOR variables and XAND collectors (both are not found or both are found)
+
+				// The routes are the same length (no changes)
+				if ($length[$a] === $length[$b]) return 0;
+
+				// The longer route moves to the end
+				return $length[$a] > $length[$b] ? 1 : -1;
 			}
+		});
+
+		// Exit (success) (fluent interface)
+		return $this;
 	}
 
 	/**
-     * Универсализация URL
+	 * Сгенерировать ответ с ошибкой
 	 *
-     * @param string $url Ссылка
+	 * Вызывает метод error404 в инстанции контроллера ошибок
 	 *
-     * @return string Универсализированная ссылка
+	 * @param ?core $core Инстанция системного ядра
+	 *
+	 * @return ?string HTML-документ
 	 */
-    private function universalization(string $url): string
+	private function error(core $core = new core): ?string
 	{
-        // Если не записан "/" в начале, то записать
-        $url = preg_replace('/^([^\/])/', '/$1', $url);
+		return class_exists($class = '\\' . $core->namespace . '\\controllers\\errors' . $core->controller::POSTFIX)
+			&& method_exists($class, $method = 'error404')
+			? (new $class)->$method()
+			: null;
+	}
 
-        // Если записан "/" в конце, то удалить
-        $url = preg_replace('/(.+)\/$/', '$1', $url);
-
-        return $url;
+	/**
+	 * Universalize URN 
+	 *
+	 * Always "/" at the beginning and never "/" at the end
+	 *
+	 * @param string &$urn URN (/foo/bar)
+	 *
+	 * @return string Universalized URN 
+	 */
+	private function universalize(string $urn): string
+	{
+		// Universalization of URN and exit (success)
+		return (string) preg_replace('/(.+)\/$/', '$1', preg_replace('/^([^\/])/', '/$1', $urn));
 	}
 }

mirzaev/minimal/system/traits/magic.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mirzaev\minimal\traits;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Trait of magical methods
+ *
+ * @method void __set(string $name, mixed $value = null) Write property
+ * @method mixed __get(string $name) Read property
+ * @method void __unset(string $name) Delete property
+ * @method bool __isset(string $name) Check property for initialization
+ *
+ * @package mirzaev\minimal\traits
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ */
+trait magic
+{
+	/**
+	 * Write property
+	 *
+	 * @param string $name Name of the property
+	 * @param mixed $value Value of the property
+	 *
+	 * @return void
+	 */
+	public function __set(string $name, mixed $value = null): void
+	{
+		match ($name) {
+			default => throw new exception('Property "' . static::class . "::\$$name\" not found", 404)
+		};
+	}
+
+	/**
+	 * Read property
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return mixed Value of the property
+	 */
+	public function __get(string $name): mixed
+	{
+		return match ($name) {
+			default => throw new exception('Property "' . static::class . "::\$$name\" not found", 404)
+		};
+	}
+
+	/**
+	 * Delete property
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return void
+	 */
+	public function __unset(string $name): void
+	{
+		match ($name) {
+			default => (function () use ($name) {
+				unset($this->{$name});
+			})()
+		};
+	}
+
+	/**
+	 * Check property for initialization
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return bool Is the property initialized?
+	 */
+	public function __isset(string $name): bool
+	{
+		return match ($name) {
+			default => isset($this->{$name})
+		};
+	}
+}