ceive/app-router

Routing in application

php-routing (Ceive\Routing)

Сущности:, _(*1)

• Единица вычисления (Matching)
  • Имеет доступ к пути, в дальнейшем и к самому HTTPRequest

• Маршрутизатор (Router), _(*2)

  • Трактуется больше как главный линейный стек/набор маршрутов
  • Пока как источник PatternResolver для Машрутов которые определены в роутере
  • Router::addPlugin - Плагины к событиям маршрутизации (Плагин это кастомный объект(stdClass) который может иметь методы-слушатели)
    • onBegin($matching); - Перед началом вычисления в Маршрутизаторе
    • onConformed($matching, $route); - При сопоставлении Шаблона в маршруте
    • onCheckEnv($matching, $route); - Проверка окружения после onConformed
    • onReached($matching, $route); - При полном сопоставлении и прохождения пути по шаблонам
    • onFinish($matching, $route); - Стек событий завершения маршрутизации после onReached
    • onPrepareRenderParams($route, $params); - Подготовка параметров для отрисовки

• Маршрут (Route), _(*3)

  • Интерфейс для получения имен плейсхолдеров
  • Вычисление match объекта Matching
  • Рендеринг шаблона по переданным аргументам в качестве подстановщиков и пре-обработки
  • Ключевые методы для кастомизации и дальнейшего расширения
    • _matchingConfirmed(Matching $matching) - Доступны параметры шаблона, пополнение Matching объекта параметрами(Биндинги/Конвертация) и ссылкой
    • _checkEnv(Matching $matching) - Проверка окружения, здесь предполагается проверка HTTP запросов, отсуда может произойти выброс в случае не удачи

Нужно подсоеденить ORM и маппинг для Binding ORM Projection paths Выборка нужного объекта по его пути., _(*4)

Разделение биндингов маршрута на разные типы, _(*5)

• Статический, _(*6)

  • Если объекты по идентификатору не найдены То происходит ошибка уровня не соответствия Это ошибка типа 404 not found

• Динамический continuable route, _(*7)

  • Если объекты по идентификаторам не найдены То маршрутизатор переходит к следующему маршруту минуя текущий - не соответствуюший

Предполагаемые проверки\реакции на HTTP запрос, _(*8)

• Наличие SSL шифрования (http|https)
• Доменное имя/под-домен/зона
• Метод запроса (Method: GET POST PUT HEAD OPTIONS)
• GET/POST параметры запроса
• JSON/XML Объект при POST запросе (вместо POST Параметров)
• Смешанный режим POST-params/Файлы/JSON|XML (multipart/form-data | multipart)
• Заголовки (Accept | Accept-Encoding) application/json text/html text/*
• Защита от неожиданных запросов с клиента и реакция нормализации(CSRF protection) например Accept: image/* не семантичный контроллеру проводящему действие CRUD

Передача приложению сигнала к реагированию (Перенаправление / Ошибка уровня запроса(BAD REQUEST)), _(*9)

brainstorm:, _(*10)

• Локации приложения / Родительские цепочки
• Переключение опций Диспетчеризации и составляющих активных компонентов системы
• Интеграция ORM(Чтение/Метаданные Секторов) для Биндинга и т.п
• Интеграция HTTP(Атрибуты запроса, Аргументы форм и Контроллеров)