a little fixes and transit into PHP 8.2

This commit is contained in:
Arsen Mirzaev Tatyano-Muradovich 2023-03-20 21:46:41 +10:00
parent 1f5685a20d
commit 3d31c92628
6 changed files with 2975 additions and 3179 deletions

View File

@ -1,39 +1,37 @@
{ {
"name": "mirzaev/minimal", "name": "mirzaev/minimal",
"type": "framework", "type": "framework",
"description": "Lightweight MVC framework that manages only the basic mechanisms, leaving the development of the programmer and not overloading the project", "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"
"license": "WTFPL", ],
"homepage": "https://git.mirzaev.sexy/mirzaev/minimal", "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.mirzaev.sexy/mirzaev/minimal/wiki", "support": {
"issues": "https://git.mirzaev.sexy/mirzaev/minimal/issues" "docs": "https://git.mirzaev.sexy/mirzaev/minimal/wiki",
}, "issues": "https://git.mirzaev.sexy/mirzaev/minimal/issues"
"require": { },
"php": "~8.1" "require": {
}, "php": "~8.2"
"suggest": { },
"ext-PDO": "To work with SQL-based databases (MySQL, PostreSQL...)" "autoload": {
}, "psr-4": {
"autoload": { "mirzaev\\minimal\\": "mirzaev/minimal/system"
"psr-4": { }
"mirzaev\\minimal\\": "mirzaev/minimal/system" },
} "autoload-dev": {
}, "psr-4": {
"autoload-dev": { "mirzaev\\minimal\\tests\\": "mirzaev/minimal/tests"
"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,181 +1,124 @@
<?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 * @package mirzaev\minimal
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy> * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/ */
class controller class controller
{ {
/** /**
* Постфикс * Постфикс
*/ */
private string $postfix = '_controller'; private 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 mixed $value Значение
* @param string $name Название *
* @param mixed $value Значение * @return void
*/ */
public function __set(string $name, mixed $value = null): void public function __set(string $name, mixed $value = null): void
{ {
match ($name) { match ($name) {
'model' => (function () use ($value) { 'POSTFIX' => throw new exception('Запрещено реинициализировать постфикс ($this::POSTFIX)', 500),
if ($this->__isset('model')) { '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);
// Запись свойства (успех) else {
$this->model = $value; // Свойство не инициализировано
} 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 ($this->__isset('view')) { /**
// Свойство уже было инициализировано * Прочитать свойство
*
// Выброс исключения (неудача) * @param string $name Название
throw new exception('Запрещено реинициализировать шаблонизатор представления ($this->view)', 500); *
} else { * @return mixed Содержимое
// Свойство ещё не было инициализировано */
public function __get(string $name): mixed
if (is_object($value)) { {
// Передано подходящее значение return match ($name) {
'POSTFIX' => $this::POSTFIX ?? throw new exception("Свойство \"POSTFIX\" не инициализировано", 500),
// Запись свойства (успех) '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 ($this->__isset('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 ($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});
})()
};
}
}

View File

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