15 Commits
0.1.0 ... 2.2.1

Author SHA1 Message Date
95ddffba30 fix postfix public 2024-01-04 04:08:44 +07:00
41bf8ab56a обновил чёто забыл уже 2023-12-21 23:14:34 +07:00
3d31c92628 a little fixes and transit into PHP 8.2 2023-03-20 21:46:41 +10:00
1f5685a20d Косметические изменения кода 2022-11-03 16:09:32 +10:00
22ad7304f9 Перенос с git.hood.su на git.mirzaev.sexy 2022-11-03 08:27:45 +10:00
Arsen Mirzaev Tatyano-Muradovich
7777d7af17 Баг при запросе маршрута с неправильным типом запроса 2022-03-04 07:15:52 +10:00
Arsen Mirzaev Tatyano-Muradovich
483814b6a5 Теперь понимает передачу файлов 2022-03-04 04:35:21 +10:00
Arsen Mirzaev Tatyano-Muradovich
e7a6b9cebe Исправления для маршрута на главную страницу 2022-03-04 02:15:42 +10:00
Arsen Mirzaev Tatyano-Muradovich
a4949ebc52 Мелкое исправление по переменным в контроллер 2022-02-28 04:40:03 +10:00
Arsen Mirzaev Tatyano-Muradovich
aeed2d21cc Доработка передачи переменных в контроллер 2022-02-28 04:30:29 +10:00
Arsen Mirzaev Tatyano-Muradovich
81990de191 Маршрутизатор теперь умеет в переменные 2022-02-28 04:22:21 +10:00
Arsen Mirzaev Tatyano-Muradovich
b6f90b7001 Исправление composer.json 2021-11-12 23:20:13 +10:00
Arsen Mirzaev Tatyano-Muradovich
db36a0a27e Исправления первой версии 2021-10-01 03:41:24 +10:00
Arsen Mirzaev Tatyano-Muradovich
ebfa14d8d6 Первая версия 2021-10-01 03:40:44 +10:00
Arsen Mirzaev Tatyano-Muradovich
2d06e386f5 Поверхностные исправления 2021-09-26 02:35:59 +10:00
11 changed files with 2973 additions and 2865 deletions

0
.gitignore vendored Normal file → Executable file
View File

81
composer.json Normal file → Executable file
View File

@@ -1,44 +1,37 @@
{
"name": "mirzaev/minimal",
"type": "framework",
"description": "Легковесный MVC фреймворк который следует твоим правилам, а не диктует свои",
"keywords": [
"mvc",
"framework"
],
"homepage": "https://git.hood.su/mirzaev/minimal",
"license": "WTFPL",
"authors": [
{
"name": "Arsen Mirzaev Tatyano-Muradovich",
"email": "arsen@mirzaev.sexy",
"homepage": "https://mirzaev.sexy",
"role": "Developer"
}
],
"support": {
"docs": "https://git.hood.su/mirzaev/minimal/manual",
"issues": "https://git.hood.su/mirzaev/minimal/issues"
},
"require": {
"php": "~8.0",
"psr/log": "~3.0",
"twig/twig": "^3.3"
},
"require-dev": {
"phpunit/phpunit": "~9.5"
},
"suggest": {
"ext-PDO": "Для работы с базами данных на SQL (MySQL, PostreSQL...)"
},
"autoload": {
"psr-4": {
"mirzaev\\minimal\\": "mirzaev/minimal/system"
}
},
"autoload-dev": {
"psr-4": {
"mirzaev\\minimal\\tests\\": "mirzaev/minimal/tests"
}
}
}
{
"name": "mirzaev/minimal",
"type": "framework",
"description": "Lightweight MVC framework that manages only the basic mechanisms, leaving the development of the programmer and not overloading the project",
"keywords": [
"mvc",
"framework",
"lightweight"
],
"license": "WTFPL",
"homepage": "https://git.mirzaev.sexy/mirzaev/minimal",
"authors": [
{
"name": "Arsen Mirzaev Tatyano-Muradovich",
"email": "arsen@mirzaev.sexy",
"homepage": "https://mirzaev.sexy",
"role": "Developer"
}
],
"support": {
"docs": "https://git.mirzaev.sexy/mirzaev/minimal/wiki",
"issues": "https://git.mirzaev.sexy/mirzaev/minimal/issues"
},
"require": {
"php": "~8.2"
},
"autoload": {
"psr-4": {
"mirzaev\\minimal\\": "mirzaev/minimal/system"
}
},
"autoload-dev": {
"psr-4": {
"mirzaev\\minimal\\tests\\": "mirzaev/minimal/tests"
}
}
}

4640
composer.lock generated Normal file → Executable file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,122 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
// Файлы проекта
use mirzaev\minimal\model;
// Встроенные библиотеки
use exception;
/**
* Контроллер
*
* @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
class controller
{
/**
* Постфикс
*/
public const POSTFIX = '_controller';
/**
* Инстанция модели
*/
protected model $model;
/**
* Инстанция шаблонизатора представления
*/
protected object $view;
/**
* Конструктор
*/
public function __construct()
{
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Значение
*
* @return void
*/
public function __set(string $name, mixed $value = null): void
{
match ($name) {
'model' => (function () use ($value) {
if ($this->__isset('model')) throw new exception('Запрещено реинициализировать свойство с инстанцией модели ($this->model)', 500);
else {
// Свойство не инициализировано
if (is_object($value)) $this->model = $value;
else throw new exception('Свойство $this->model должно хранить инстанцию модели (объект)', 500);
}
})(),
'view' => (function () use ($value) {
if ($this->__isset('view')) throw new exception('Запрещено реинициализировать свойство с инстанцией шаблонизатора представления ($this->view)', 500);
else {
// Свойство не инициализировано
if (is_object($value)) $this->view = $value;
else throw new exception('Свойство $this->view должно хранить инстанцию шаблонизатора представления (объект)', 500);
}
})(),
default => throw new exception("Свойство \"\$$name\" не найдено", 404)
};
}
/**
* Прочитать свойство
*
* @param string $name Название
*
* @return mixed Содержимое
*/
public function __get(string $name): mixed
{
return match ($name) {
'model' => $this->model ?? throw new exception("Свойство \"\$model\" не инициализировано", 500),
'view' => $this->view ?? throw new exception("Свойство \"\$view\" не инициализировано", 500),
default => throw new exception("Свойство \"\$$name\" не обнаружено", 404)
};
}
/**
* Проверить свойство на инициализированность
*
* @param string $name Название
*
* @return bool Инициализировано свойство?
*/
public function __isset(string $name): bool
{
return match ($name) {
default => isset($this->{$name})
};
}
/**
* Удалить свойство
*
* @param string $name Название
*
* @return void
*/
public function __unset(string $name): void
{
match ($name) {
default => (function () use ($name) {
// Удаление
unset($this->{$name});
})()
};
}
}

View File

@@ -1,148 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal\controllers;
use mirzaev\minimal\core;
use mirzaev\minimal\models\model;
use Twig\Loader\FilesystemLoader;
use Twig\Environment as view;
use Exception;
/**
* Контроллер
*
* @package mirzaev\minimal\controllers
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
class controller
{
/**
* @var model $model Модель
*/
protected model $model;
/**
* @var view $view Шаблонизатор представления
*/
protected view $view;
/**
* Конструктор
*
* @return void
*/
public function __construct()
{
// Установка значения по умолчанию для модели (если будет найдена)
$this->__get('model');
// Установка значения по умолчанию для шаблонизатора представлений
$this->__get('view');
}
/**
* Отрисовка шаблона
*
* @param string $route Маршрут
*/
public function view(string $route)
{
// Чтение представления по шаблону пути: "/views/[controller]/index
// Никаких слоёв и шаблонизаторов
// Не стал в ядре записывать путь до шаблонов
if (file_exists($view = core::path() . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'views' . DIRECTORY_SEPARATOR . $route . DIRECTORY_SEPARATOR . 'index.html')) {
include $view;
}
}
/**
* Записать свойство
*
* @param mixed $name Название
* @param mixed $value Значение
*
* @return void
*/
public function __set($name, $value): void
{
if ($name === 'model') {
if (!isset($this->model)) {
$this->model = $value;
return;
} else {
throw new Exception('Запрещено переопределять модель');
}
} else if ($name === 'view') {
if (!isset($this->view)) {
$this->view = $value;
return;
} else {
throw new Exception('Запрещено переопределять шаблонизатор представления');
}
}
throw new Exception('Свойство не найдено: ' . $name);
}
/**
* Прочитать свойство
*
* @param mixed $name Название
*
* @return mixed
*/
public function __get($name)
{
if ($name === 'model') {
if (isset($this->model)) {
// Если модель найдена
return $this->model;
} else {
// Инициализация класса модели
$model = preg_replace('/' . core::controllerPostfix() . '$/i', '', basename(get_class($this))) . core::modelPostfix();
// Иначе
if (class_exists($model_class = core::namespace() . '\\models\\' . $model)) {
// Если найдена одноимённая с контроллером модель (без постфикса)
return $this->model = new $model_class;
}
return;
}
} else if ($name === 'view') {
if (isset($this->view)) {
// Если модель найдена
return $this->view;
} else {
$path = core::path() . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'views';
$loader = new FilesystemLoader($path);
return $this->view = (new view($loader, [
// 'cache' => $path . DIRECTORY_SEPARATOR . 'cache',
]));
}
}
throw new Exception('Свойство не найдено: ' . $name);
}
/**
* Проверить свойство на инициализированность
*
* @param string $name Название
*
* @return mixed
*/
public function __isset(string $name)
{
if ($name === 'model') {
return isset($this->model);
} else if ($name === 'view') {
return isset($this->view);
}
throw new Exception('Свойство не найдено: ' . $name);
}
}

371
mirzaev/minimal/system/core.php Normal file → Executable file
View File

@@ -1,141 +1,230 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
use mirzaev\minimal\router;
use PDO;
use PDOException;
use Exception;
/**
* Ядро
*
* @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
final class core
{
/**
* @var PDO $db Соединение с базой данных
*/
private static PDO $db;
/**
* @var router $router Маршрутизатор
*/
private static router $router;
/**
* @var string $path Корневая директория
*/
private static string $path;
/**
* @var string $namespace Пространство имён
*/
private static string $namespace;
/**
* @var string $postfix_controller Постфикс контроллеров
*/
private static string $postfix_controller = '_controller';
/**
* @var string $postfix_model Постфикс моделей
*/
private static string $postfix_model = '_model';
/**
* Конструктор
*
* @param string $db
* @param string $login
* @param string $password
* @param router $router Маршрутизатор
*/
public function __construct(string $db = 'mysql:dbname=db;host=127.0.0.1', string $login = '', string $password = '', router $router = null)
{
// Инициализация маршрутизатора
self::$router = $router ?? new router;
// Инициализация корневого пространства имён
self::$namespace = __NAMESPACE__;
try {
// Инициализация PDO
self::$db = new PDO($db, $login, $password);
} catch (PDOException $e) {
throw new Exception('Проблемы при соединении с базой данных: ' . $e->getMessage(), $e->getCode());
}
// Обработка запроса
self::$router::handle();
}
/**
* Деструктор
*
*/
public function __destruct()
{
// Закрытие соединения
}
/**
* Прочитать/записать корневую директорию
*
* @var string|null $path Путь
*
* @return string
*/
public static function path(string $path = null): string
{
return self::$path = (string) ($path ?? self::$path);
}
/**
* Прочитать/записать соединение с базой данных
*
* @var PDO|null $db Соединение с базой данных
*
* @return PDO
*/
public static function db(PDO $db = null): PDO
{
return self::$db = $db ?? self::$db;
}
/**
* Прочитать постфикс контроллеров
*
* @return string|null
*/
public static function controllerPostfix(): ?string
{
return self::$postfix_controller;
}
/**
* Прочитать постфикс моделей
*
* @return string|null
*/
public static function modelPostfix(): ?string
{
return self::$postfix_model;
}
/**
* Прочитать пространство имён
*
* @return string|null
*/
public static function namespace(): ?string
{
return self::$namespace;
}
}
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
// Файлы проекта
use mirzaev\minimal\router,
mirzaev\minimal\controller,
mirzaev\minimal\model;
// Встроенные библиотеки
use exception,
ReflectionClass as reflection;
/**
* Ядро
*
* @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*
* @todo
* 1. Добавить __isset() и __unset()
*/
final class core
{
/**
* Инстанция соединения с базой данных
*/
private object $db;
/**
* Инстанция маршрутизатора
*/
private readonly router $router;
/**
* Инстанция ядра контроллера
*/
private readonly controller $controller;
/**
* Инстанция ядра модели
*/
private readonly model $model;
/**
* Путь пространства имён (системное)
*
* Используется для поиска файлов по спецификации PSR-4
*/
private readonly string $namespace;
/**
* Конструктор
*
* @param ?object $db Инстанция соединения с базой данных
* @param ?router $router Маршрутизатор
* @param ?controller $controller Инстанция ядра контроллера
* @param ?model $model Инстанция ядра модели
* @param ?string $namespace Пространство имён системного ядра
*
* @return self Инстанция ядра
*/
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()
{
}
/**
* Запуск
*
* @param ?string $uri Маршрут
*
* @return string|int|null Ответ
*/
public function start(string $uri = null): string|int|null
{
// Обработка запроса
return $this->__get('router')->handle($uri, core: $this);
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Содержимое
*
* @return void
*/
public function __set(string $name, mixed $value = null): void
{
match ($name) {
'db', 'database' => (function () use ($value) {
if ($this->__isset('db')) throw new exception('Запрещено реинициализировать инстанцию соединения с базой данных ($this->db)', 500);
else {
// Свойство ещё не было инициализировано
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 ($value instanceof router) $this->router = $value;
else throw new exception('Свойство $this->router должно хранить инстанцию маршрутизатора (mirzaev\minimal\router)"', 500);
}
})(),
'controller' => (function () use ($value) {
if ($this->__isset('controller')) throw new exception('Запрещено реинициализировать инстанцию ядра контроллеров ($this->controller)', 500);
else {
// Свойство не инициализировано
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')) throw new exception('Запрещено реинициализировать инстанцию ядра моделей ($this->model)', 500);
else {
// Свойство не инициализировано
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')) throw new exception('Запрещено реинициализировать путь пространства имён ($this->namespace)', 500);
else {
// Свойство не инициализировано
if (is_string($value)) $this->namespace = $value;
else throw new exception('Свойство $this->namespace должно хранить строку с путём пространства имён', 500);
}
})(),
default => throw new exception("Свойство \"\$$name\" не найдено", 404)
};
}
/**
* Прочитать свойство
*
* Записывает значение по умолчанию, если свойство не инициализировано
*
* @param string $name Название
*
* @return mixed Содержимое
*/
public function __get(string $name): mixed
{
return match ($name) {
'db', 'database' => $this->db ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
'router' => (function () {
// Инициализация со значением по умолчанию
if (!$this->__isset('router')) $this->__set('router', new router);
// Возврат (успех)
return $this->router;
})(),
'controller' => (function () {
// Инициализация со значением по умолчанию
if (!$this->__isset('controller')) $this->__set('controller', new controller);
// Возврат (успех)
return $this->controller;
})(),
'model' => (function () {
// Инициализация со значением по умолчанию
if (!$this->__isset('model')) $this->__set('model', new model);
// Возврат (успех)
return $this->model;
})(),
'namespace' => $this->namespace ?? throw new exception("Свойство \"\$$name\" не инициализировано", 500),
default => throw new exception("Свойство \"\$$name\" не найдено", 404)
};
}
/**
* Проверить свойство на инициализированность
*
* @param string $name Название
*
* @return bool Инициализировано свойство?
*/
public function __isset(string $name): bool
{
return match ($name) {
default => isset($this->{$name})
};
}
/**
* Удалить свойство
*
* @param string $name Название
*
* @return void
*/
public function __unset(string $name): void
{
match ($name) {
default => (function () use ($name) {
// Удаление
unset($this->{$name});
})()
};
}
}

View File

@@ -0,0 +1,89 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
// Встроенные библиотеки
use exception;
/**
* Модель
*
* @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
class model
{
/**
* Постфикс
*/
public const POSTFIX = '_model';
/**
* Конструктор
*/
public function __construct()
{
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Содержимое
*
* @return void
*/
public function __set(string $name, mixed $value = null): void
{
match ($name) {
default => throw new exception("Свойство \"\$$name\" не найдено", 404)
};
}
/**
* Прочитать свойство
*
* @param string $name Название
*
* @return mixed Содержимое
*/
public function __get(string $name): mixed
{
return match ($name) {
default => throw new exception("Свойство \"\$$name\" не обнаружено", 404)
};
}
/**
* Проверить свойство на инициализированность
*
* @param string $name Название
*
* @return bool Инициализировано свойство?
*/
public function __isset(string $name): bool
{
return match ($name) {
default => isset($this->{$name})
};
}
/**
* Удалить свойство
*
* @param string $name Название
*
* @return void
*/
public function __unset(string $name): void
{
match ($name) {
default => (function () use ($name) {
// Удаление
unset($this->{$name});
})()
};
}
}

View File

@@ -1,90 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal\models;
use mirzaev\minimal\core;
use PDO;
use Exception;
/**
* Модель
*
* @package mirzaev\minimal\models
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
class model
{
/**
* @var PDO $db Соединение с базой данных
*/
protected PDO $db;
/**
* Конструктор
*
* @param PDO|null $db Соединение с базой данных
*/
public function __construct(PDO $db = null)
{
$this->db = $db ?? core::db();
}
/**
* Записать свойство
*
* @param mixed $name Название
* @param mixed $value Значение
*
* @return void
*/
public function __set($name, $value): void
{
if ($name === 'db') {
if (!isset($this->db)) {
$this->db = $value;
return;
} else {
throw new Exception('Запрещено переопределять соединение с базой данных');
}
}
throw new Exception('Свойство не найдено: ' . $name);
}
/**
* Прочитать свойство
*
* @param mixed $name Название
*
* @return mixed
*/
public function __get($name)
{
if ($name === 'db') {
return $this->db;
}
throw new Exception('Свойство не найдено: ' . $name);
}
/**
* Проверить свойство на инициализированность
*
* @param string $name Название
*
* @return mixed
*/
public function __isset(string $name)
{
if ($name === 'db') {
return isset($this->db);
}
throw new Exception('Свойство не найдено: ' . $name);
}
}

297
mirzaev/minimal/system/router.php Normal file → Executable file
View File

@@ -1,122 +1,175 @@
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
use mirzaev\shop\core;
/**
* Маршрутизатор
*
* @package mirzaev\shop
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
final class router
{
/**
* @var array $router Маршруты
*/
public static array $routes = [];
/**
* Новый маршрут
*
* @param string $route Маршрут
* @param string $controller Контроллер
* @param string|null $method Метод
* @param string|null $type Тип
* @param string|null $model Модель
*
* @return void
*/
public static function create(string $route, string $controller, string $method = null, string $type = 'GET', string $model = null): void
{
if (is_null($model)) {
$model = $controller;
}
self::$routes[$route][$type] = [
// Инициализация контроллера с постфиксом
'controller' => preg_match('/' . core::controllerPostfix() . '$/i', $controller) ? $controller : $controller . core::controllerPostfix(),
'model' => preg_match('/' . core::modelPostfix() . '$/i', $model) ? $model : $model . core::modelPostfix(),
'method' => $method ?? '__construct'
];
}
/**
* Обработка маршрута
*
* @param string $route Маршрут
* @param string $controller Контроллер
*
* @return void
*/
public static function handle(string $uri = null): void
{
// Если не передан URI, то взять из данных веб-сервера
$uri = $uri ?? $_SERVER['REQUEST_URI'] ?? '';
// Инициализация URL
$url = parse_url($uri, PHP_URL_PATH);
// Сортировка массива маршрутов от большего ключа к меньшему
krsort(self::$routes);
foreach (self::$routes as $key => $value) {
// Если не записан "/" в начале, то записать
$route_name = preg_replace('/^([^\/])/', '/$1', $key);
$url = preg_replace('/^([^\/])/', '/$1', $url);
// Если не записан "/" в конце, то записать
$route_name = preg_replace('/([^\/])$/', '$1/', $route_name);
$url = preg_replace('/([^\/])$/', '$1/', $url);
if (mb_stripos($route_name, $url, 0, "UTF-8") === 0 && mb_strlen($route_name, 'UTF-8') <= mb_strlen($url, 'UTF-8')) {
// Если найден маршрут, а так же его длина не меньше длины запрошенного URL
$route = $value[$_SERVER["REQUEST_METHOD"] ?? 'GET'];
break;
}
}
if (!empty($route)) {
// Если маршрут найден
if (class_exists($controller_class = core::namespace() . '\\controllers\\' . $route['controller'])) {
// Если найден класс-контроллер маршрута
$controller = new $controller_class;
if (empty($response = $controller->{$route['method']}($_REQUEST))) {
// Если не получен ответ после обработки контроллера
// Удаление постфикса для поиска директории
$dir = preg_replace('/' . core::controllerPostfix() . '$/i', '', $route['controller']);
// Отрисовка шаблона по умолчанию
$response = $controller->view($dir);
}
echo $response;
return;
}
}
echo self::error();
}
private static function error(): ?string
{
if (
class_exists($class = core::namespace() . '\\controllers\\errors' . core::controllerPostfix()) &&
method_exists($class, $method = 'error404')
) {
// Если существует контроллер ошибок и метод-обработчик ответа 404,
// то вызвать обработку ответа 404
return (new $class(basename($class)))->$method();
} else {
// Никаких исключений не вызывать, отдать пустую страницу
// Либо можно, но отображать в зависимости от включенного дебаг режима
return null;
}
}
}
<?php
declare(strict_types=1);
namespace mirzaev\minimal;
// Файлы проекта
use mirzaev\minimal\core;
/**
* Маршрутизатор
*
* @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
final class router
{
/**
* @var array $router Реестр маршрутов
*/
protected array $routes = [];
/**
* Записать маршрут
*
* @param string $route Маршрут
* @param string $handler Обработчик - инстанции контроллера и модели (не обязательно), без постфиксов
* @param ?string $method Вызываемый метод в инстанции контроллера обработчика
* @param ?string $request HTTP-метод запроса (GET, POST, PUT...)
* @param ?string $model Инстанция модели (переопределение инстанции модели в $target)
*
* @return void
*/
public function write(
string $route,
string $handler,
?string $method = 'index',
?string $request = 'GET',
?string $model = null
): void {
// Запись в реестр
$this->routes[$route][$request] = [
'controller' => $handler,
'model' => $model ?? $handler,
'method' => $method
];
}
/**
* Обработать маршрут
*
* @param ?string $uri URI запроса (https://domain.com/foo/bar)
* @param ?string $method Метод запроса (GET, POST, PUT...)
* @param ?core $core Инстанция системного ядра
*
* @return string|int|null Ответ
*/
public function handle(?string $uri = null, ?string $method = null, ?core $core = new core): string|int|null
{
// Инициализация значений по умолчанию
$uri ??= $_SERVER['REQUEST_URI'] ?? '/';
$method ??= $_SERVER["REQUEST_METHOD"] ?? 'GET';
// Инициализация URL запроса (/foo/bar)
$url = parse_url($uri, PHP_URL_PATH);
// Универсализация маршрута
$url = self::universalize($url);
// Сортировка реестра маршрутов от большего ключа к меньшему (кешируется)
krsort($this->routes);
// Поиск директорий в ссылке
preg_match_all('/[^\/]+/', $url, $directories);
// Инициализация директорий
$directories = $directories[0];
foreach ($this->routes as $route => $data) {
// Перебор маршрутов
// Универсализация маршрута
$route = self::universalize($route);
// Поиск директорий
preg_match_all('/[^\/]+/', $route, $data['directories']);
// Инициализация директорий
$data['directories'] = $data['directories'][0];
if (count($directories) === count($data['directories'])) {
// Входит в диапазон маршрут (совпадает количество директорий у ссылки и маршрута)
// Инициализация реестра переменных
$data['vars'] = [];
foreach ($data['directories'] as $index => &$directory) {
// Перебор директорий
if (preg_match('/\$([a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]+)/', $directory) === 1) {
// Директория является переменной (.../$variable/...)
// Запись в реестр переменных
$directory = $data['vars'][trim($directory, '$')] = $directories[$index];
}
}
// Реиницилазция маршрута
$route = self::universalize(implode('/', $data['directories']));
// Проверка на пустой маршрут
if (empty($route)) $route = '/';
if (mb_stripos($route, $url, 0, "UTF-8") === 0 && mb_strlen($route, 'UTF-8') <= mb_strlen($url, 'UTF-8')) {
// Идентифицирован маршрут (длина не меньше длины запрошенного URL)
if (array_key_exists($method, $data)) {
// Идентифицирован метод маршрута (GET, POST, PUT...)
$route = $data[$method];
if (class_exists($controller = $core->namespace . '\\controllers\\' . $route['controller'] . $core->controller::POSTFIX)) {
// Найден контроллер
// Инициализация инстанции ядра контроллера
$controller = new $controller;
// Инициализация инстанции ядра модели
if (class_exists($model = $core->namespace . '\\models\\' . $route['model'] . $core->model::POSTFIX));
// Вызов связанного с маршрутом методв и возврат (успех)
return $controller->{$route['method']}($data['vars'] + $_REQUEST, $_FILES);
}
}
// Выход из цикла (провал)
break;
}
}
}
// Возврат (провал)
return $this->error($core);
}
/**
* Сгенерировать ответ с ошибкой
*
* Вызывает метод error404 в инстанции контроллера ошибок
*
* @param ?core $core Инстанция системного ядра
*
* @return ?string HTML-документ
*/
private function error(core $core = new core): ?string
{
return class_exists($class = '\\' . $core->namespace . '\\controllers\\errors' . $core->controller::POSTFIX)
&& method_exists($class, $method = 'error404')
? (new $class)->$method()
: null;
}
/**
* Универсализировать маршрут
*
* @param string $route Маршрут
*
* @return string Универсализированный маршрут
*/
private function universalize(string $route): string
{
// Если не записан "/" в начале, то записать, затем, если записан "/" в конце, то удалить
return preg_replace('/(.+)\/$/', '$1', preg_replace('/^([^\/])/', '/$1', $route));
}
}