Создание сущности включает в себя два действия: отображение формы и обработка данных формы. За каждое из этих действий отвечает собственный маршрут. Вот несколько примеров:
Пользователь
- GET
/users/new
- POST
/users
Курс
- GET
/courses/new
- POST
/courses
Сотрудник компании (пример вложенного маршрута)
- GET
/companies/3/users/new
- POST
/companies/3/users
Отображение формы
Обработчик
<?php
$app->get('/schools/new', function ($request, $response) {
$params = [
'schoolData' => [],
'errors' => []
];
return $this->get('renderer')->render($response, 'schools/new.phtml', $params);
})->setName('newSchool');
Шаблон
<form action="/schools" method="post">
<div>
<label>
Название *
<input type="text" name="school[name]" value="<?= htmlspecialchars($schoolData['name'] ?? ''); ?>">
</label>
<?php if (isset($errors['name'])): ?>
<div><?= $errors['name'] ?></div>
<?php endif ?>
</div>
<input type="submit" value="Create">
</form>
Содержимое обработчика зависит от того, какой используется инструментарий. В местах, где есть билдеры форм, в этом обработчике создается форма как некоторый объект и отправляется в шаблон.
Билдер берет на себя большое количество задач: обрабатывает вывод ошибок, занимается валидацией и подготовкой данных. Некоторые билдеры знают про ту сущность, с которой они работают. Поэтому могут строить формы в полностью автоматическом режиме.
В нашем примере такого нет, поэтому все действия делаются руками. Кроме данных в шаблон передается массив errors
. Это нужно, потому что форма используется обоими обработчиками: одним — только для отображения новой формы, другим — для отображения формы в случае наличия ошибок.
Обработка данных формы
<?php
$router = $app->getRouteCollector()->getRouteParser();
$app->post('/schools', function ($request, $response) use ($router) {
$repo = new App\SchoolRepository();
// Извлекаем данные формы
$schoolData = $request->getParsedBodyParam('school');
$validator = new Validator();
// Проверяем корректность данных
$errors = $validator->validate($schoolData);
if (count($errors) === 0) {
// Если данные корректны, то сохраняем, добавляем флеш и выполняем редирект
$repo->save($schoolData);
$this->get('flash')->addMessage('success', 'School has been created');
// Обратите внимание на использование именованного роутинга
$url = $router->urlFor('schools');
return $response->withRedirect($url);
}
$params = [
'schoolData' => $schoolData,
'errors' => $errors
];
// Если возникли ошибки, то устанавливаем код ответа в 422 и рендерим форму с указанием ошибок
$response = $response->withStatus(422);
return $this->get('renderer')->render($response, 'schools/new.phtml', $params);
});
Своего шаблона у таких обработчиков нет. Если данные оказались не валидны, то этот обработчик рисует форму обработчика new
и отправляет ее вместе с кодом ответа 422 (Unprocessable Entity). Если данные корректны, то выполняется основная логика обработчика — происходит сохранение школы в базу данных $repo->save($schoolData)
. Затем редирект на список школ с оповещением через флеш об успешном добавлении.
Самостоятельная работа
-
Сделайте все поля формы создания пользователя обязательными
-
Реализуйте обработку введенных данных и рендеринг формы с выводом ошибок
Остались вопросы? Задайте их в разделе «Обсуждение»
Вам ответят команда поддержки Хекслета или другие студенты
Для полного доступа к курсу нужен базовый план
Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.