16.2. Создание модуля User
Итак, первое, что мы создадим для приложения User Demo - новый модуль с именем User. В этот модуль мы добавим всю функциональность, связанную с управлением пользователями и аутентификацией. Если вы еще не знакомы с концепцией модулей, обратитесь к главе Создание нового модуля.
Модуль User будет иметь очень малое количество зависимостей от других модулей веб-сайта. Цель создания этого модуля - сделать многократно используемый блок, который вы можете использовать в своем веб-приложении без каких-либо изменений (либо с небольшими модификациями).
В идеале, вы сможете использовать модуль User при разработке своего сайта, не внося в модуль никаких изменений. Однако, для реальных сайтов вам, возможно, придется добавить какие-нибудь поля в таблицу
user, изменить рабочий процесс создания пользователя или модифицировать алгоритм фильтрации доступа. В таком случае вам нужно будет адаптировать код под свои нужды.
Модуль User будет иметь следующую структуру (см. рисунок 16.1 ниже):
Рисунок 16.1. Структура модуля User
Ниже мы вкратце опишем классы, которые будут находиться в каталоге модуля.
У нас будет два контроллера:
- UserController будет содержать функциональность для управления пользователями (добавление, изменение, смена пароля и т.д.)
- AuthController будет реализовывать функциональность для аутентификации (вход в аккаунт и выход из него)
Будет одна сущность Doctrine:
- Сущность User будет использоваться для хранения информации о пользователе в базе данных (адрес эл. почты, полное имя, пароль и т.д.).
Четыре формы для сбора данных:
- LoginForm будет использоваться для сбора данных аутентификации (логина и пароля).
- PasswordChangeForm будет использоваться для сбора данных для изменения или сброса пароля пользователя.
- PasswordResetForm будет использоваться для получения адреса электронной почты человека, который забыл свой пароль и хочет его восстановить.
- UserForm будет использоваться для сбора данных о пользователе (адрес эл. почты, полное имя, пароль и т.д.).
И несколько сервисов:
- Сервис AuthAdapter будет реализовывать алгоритм аутентификации. Он будет проверять, корректны ли логин (адрес эл. почты) и пароль пользователя. Для осуществления этой проверки, он будет извлекать из базы данных информацию о пользователе.
- Сервис AuthManager будет совершать фактическую аутентификацию (вход в аккаунт на сайте и выход). Помимо этого, он будет реализовывать фильтр доступа, который может отказать не вошедшим на сайт пользователям в доступе к определенным веб-страницам.
- UserManager будет содержать бизнес-логику управления пользователями (добавление, изменение, смена пароля).
Большинство контроллеров и сервисов будут инстанцированы с помощью фабрик. Классы фабрик можно найти под подкаталогами Factory.
Внутри каталога view будет находиться несколько шаблонов представлений, которые будут визуализировать HTML-разметку страниц пользовательского интерфейса из нашего модуля.
Как и обычно, в каталоге config будет находиться файл module.config.php, который будет содержать маршруты и регистрацию для наших контроллеров и сервисов. Он также будет содержать ключ access_filter, определяющий, какие веб-страницы будут доступны не вошедшему на сайт пользователю (этот ключ будет считываться сервисом AuthManager).
Как видите, модуль User - это обычный модуль ZF3, имеющий структуру, которая соответствует шаблону проектирования MVC.