УРОК · Laravel: приложение и данные

Форма и проверка запроса

Опубликовано Автор: Соловьёва Мария Андреевна

Список уже читает таблицу. Добавим локальную форму и POST /notes, проверяя заголовок до записи.

Разберём по шагам

Форма отправляет title и необязательный body. Директива @csrf добавляет скрытый токен для запроса из браузера; без него Laravel отклонит обычный POST. Контроллер проверяет данные на сервере, записывает только разрешённые поля модели и отвечает перенаправлением 303 на список. Это локальный учебный каталог без входа: любой посетитель локального сервера может добавить заметку. Владелец записи и запрет чужих изменений здесь не реализуются. Ниже четыре подписанные части для четырёх отдельных файлов.

Слова, которые пригодятся

CSRF-токен
Скрытое значение формы, которое Laravel сверяет при изменяющем запросе из браузера; оно не заменяет вход пользователя.
Валидация
Проверка данных запроса до записи. Здесь title обязателен и не длиннее 200 символов, а body может быть пустым.
Массовое заполнение
Передача массива полей в Note::create; $fillable разрешает только title и body.
Перенаправление 303
Ответ после POST, который направляет браузер открыть список новым GET-запросом.

Правило required работает на сервере даже при удалённом HTML-атрибуте required; max:200 не полагается на maxlength в браузере. Пустой body после нормализации превращается в NULL, а код сохраняет вместо него пустую строку, как в учебной таблице body TEXT NOT NULL.

Blade-выражения {{ ... }} экранируют заголовок и текст. @csrf защищает от поддельной отправки формы из другого сайта, но не создаёт вход и не ограничивает, кто может добавлять записи. Поэтому приложение запускается только локально; права владельца станут отдельной задачей после добавления входа.

Рабочий пример

app/Models/Note.php — весь файл:
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Note extends Model
{
    protected $fillable = ['title', 'body'];
}

app/Http/Controllers/NoteController.php — весь файл:
<?php
namespace App\Http\Controllers;
use App\Models\Note;
use Illuminate\Http\Request;
class NoteController extends Controller
{
    public function index()
    {
        return view('notes.index', [
            'notes' => Note::query()->orderByDesc('id')->get(),
        ]);
    }

    public function store(Request $request)
    {
        $data = $request->validate([
            'title' => ['required', 'string', 'max:200'],
            'body' => ['nullable', 'string'],
        ]);
        Note::create([
            'title' => $data['title'],
            'body' => $data['body'] ?? '',
        ]);
        return redirect('/notes', 303);
    }
}

resources/views/notes/index.blade.php — весь файл:
<!doctype html>
<html lang="ru">
<head><meta charset="utf-8"><title>Заметки</title></head>
<body>
<h1>Заметки</h1>
@if ($errors->any())
    <p role="alert">{{ $errors->first() }}</p>
@endif
<form method="post" action="/notes">
    @csrf
    <label>Название <input name="title" value="{{ old('title') }}" maxlength="200" required></label>
    <label>Текст <textarea name="body">{{ old('body') }}</textarea></label>
    <button type="submit">Сохранить</button>
</form>
<ul>
@forelse ($notes as $note)
    <li><strong>{{ $note->title }}</strong> {{ $note->body }}</li>
@empty
    <li>Пока пусто</li>
@endforelse
</ul>
</body>
</html>

routes/web.php — весь файл:
<?php
use App\Http\Controllers\NoteController;
use Illuminate\Support\Facades\Route;
Route::get('/notes', [NoteController::class, 'index']);
Route::post('/notes', [NoteController::class, 'store']);

Практика

Добавьте заметку через форму и увидите её после перенаправления. В следующем уроке автоматический тест проверит и успешную запись, и обход ограничений браузера.

  1. В Visual Studio Code в уже открытом notes-laravel полностью замените app/Models/Note.php, app/Http/Controllers/NoteController.php, resources/views/notes/index.blade.php и routes/web.php соответствующими четырьмя частями примера. Не вставляйте подписи файлов из примера в PHP или Blade. Сохраните каждый файл Ctrl+S. Выполните php -l app/Models/Note.php, php -l app/Http/Controllers/NoteController.php и php artisan route:list --path=notes: ожидайте два маршрута — GET|HEAD и POST.
  2. Из корня notes-laravel запустите php artisan serve --host=127.0.0.1 --port=8001. Откройте http://127.0.0.1:8001/notes в браузере, введите название PHP и Laravel и текст, нажмите «Сохранить». Ожидайте переход обратно на /notes и новую строку списка. Добавьте заголовок с апострофом: он должен отображаться как текст. Пустое поле title браузер не отправит из-за required; серверный отказ при обходе формы проверим HTTP-тестом следующего урока.
  3. Во втором терминале Ubuntu выполните curl -i --data "title=NoToken" http://127.0.0.1:8001/notes: без @csrf-токена ожидайте 419 и отсутствие новой строки. Убедитесь, что форма содержит @csrf, а .env и database/database.sqlite остаются вне публичной папки public. Остановите сервер Ctrl+C.

Как проверить себя

Локальная форма добавляет запись, затем возвращает 303 на список; заголовок с апострофом выводится как текст. POST без CSRF-токена отклоняется с 419, а серверная проверка названия будет доказана тестом.

Если не получилось
  • POST возвращает 419 при отправке формы? Проверьте наличие @csrf и что браузер отправляет cookie той же локальной сессии; не отключайте CSRF ради прохождения упражнения.
  • Add [title] to fillable property? Проверьте точный $fillable в app/Models/Note.php и сохранение файла.
  • После отправки видно ошибку SQL? Проверьте статус миграции create_notes_table, .env с SQLite и тот же файл database/database.sqlite, который использует запущенный сервер.

Куда заглянуть дальше