11 Commits
1.0.0 ... 2.1.1

6 changed files with 2971 additions and 3108 deletions

View File

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

4640
composer.lock generated

File diff suppressed because it is too large Load Diff

View File

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

View File

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

View File

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

View File

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