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

Тесты сценария и фоновая работа

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

Форма работает вручную; закрепим это HTTP-тестами на отдельной базе и обозначим границы будущих прав и очереди.

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

Laravel создаёт тестовый запрос без браузера. RefreshDatabase готовит схему в SQLite :memory: из phpunit.xml, поэтому тесты не меняют файл учебного приложения, прежний notes-php или WordPress. Проверяем гостевой локальный сценарий: список, создание, пустое и длинное название, отсутствующий маршрут и неверный метод. В Laravel HTTP-тестах CSRF-проверка отключена самим тестовым окружением; реальный отказ 419 проверен в прошлом уроке. Здесь нет входа, удаления или фоновой задачи. Вопросы о владельце, чужом удалении и очереди описывают правила для будущей реализации, а не уже пройденные тесты.

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

HTTP-тест
Код, который посылает приложению тестовый запрос и проверяет статус, HTML и данные.
RefreshDatabase
Средство Laravel, которое готовит и очищает тестовую базу между проверками.
Владелец записи
Вошедший пользователь, чьи права на конкретную запись предстоит проверить после добавления входа; сейчас такого поля нет.
Очередь
Способ выполнить медленную побочную задачу отдельно от HTTP-ответа; в этом каталоге задачи пока не создаются.

Тест называется local_guest_can_create... намеренно: без входа приложение принимает локальный POST от любого посетителя. Не публикуйте этот учебный сервер как многопользовательский сервис. Скрытое поле user_id не определяло бы владельца надёжно, потому что клиент может подменить его; после внедрения входа владелец должен браться из текущего пользователя.

Когда появятся изменение и удаление, тест чужой записи должен проверить отказ и неизменность строки в базе. Здесь таких маршрутов нет, поэтому проверять чужое удаление было бы фикцией. Очередь оправдана, например, для письма после успешного сохранения; задача должна выдерживать повторное выполнение без дублирования заметки.

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

<?php
// notes-laravel/tests/Feature/NotesTest.php — весь файл
namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class NotesTest extends TestCase
{
    use RefreshDatabase;

    public function test_local_guest_can_create_and_read_a_note(): void
    {
        $this->get('/notes')->assertOk()->assertSee('Пока пусто');
        $this->post('/notes', ['title' => "О'Брайен", 'body' => 'Текст'])
            ->assertStatus(303)->assertRedirect('/notes');
        $this->assertDatabaseHas('notes', ['title' => "О'Брайен", 'body' => 'Текст']);
        $this->get('/notes')->assertOk()->assertSeeText("О'Брайен");
    }

    public function test_invalid_titles_do_not_create_notes(): void
    {
        $this->from('/notes')->post('/notes', ['title' => '  ', 'body' => 'x'])
            ->assertRedirect('/notes')->assertSessionHasErrors('title');
        $this->from('/notes')->post('/notes', ['title' => str_repeat('x', 201), 'body' => 'x'])
            ->assertRedirect('/notes')->assertSessionHasErrors('title');
        $this->assertDatabaseCount('notes', 0);
    }

    public function test_unknown_page_and_method_return_errors(): void
    {
        $this->get('/missing')->assertNotFound();
        $this->put('/notes')->assertStatus(405);
    }
}

Практика

Проверьте сценарий без ручного повторения формы и запишите, что именно доказано. Это станет точкой отсчёта перед будущей авторизацией и фоновыми задачами.

  1. В Visual Studio Code в папке notes-laravel/tests/Feature создайте NotesTest.php, вставьте весь пример и сохраните Ctrl+S. Сверьте в phpunit.xml значения DB_CONNECTION=sqlite и DB_DATABASE=:memory:; они относятся только к тестовой среде. Выполните php -l tests/Feature/NotesTest.php.
  2. Из корня notes-laravel выполните php artisan test --filter=NotesTest. Ожидайте три пройденных теста: допустимый POST даёт 303 и строку в базе, пустой и 201-символьный заголовки дают ошибки без строк, /missing даёт 404, PUT /notes — 405. Затем откройте обычный /notes: строка из теста там не появилась, потому что тестовая база отдельная.
  3. Запишите в README.md границу этой версии: локальный гость сейчас может создать заметку; входа, user_id, изменения и удаления нет. Для будущей многопользовательской версии понадобятся получение владельца из вошедшего пользователя и HTTP-тест отказа при изменении чужой записи с проверкой, что данные остались. Очередь применяйте лишь к медленной побочной работе, например письму после записи; до появления письма и обработчика очереди запускать нечего.

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

Три HTTP-теста проходят на отдельной базе и подтверждают реальные маршруты, валидацию и отсутствие записи при ошибке. Документ не выдаёт будущую авторизацию или очередь за работающую функцию.

Если не получилось
  • Тест сообщает no such table: notes? Убедитесь, что файл миграции create_notes_table сохранён и phpunit.xml использует SQLite :memory:.
  • assertStatus(303) получил 302? Проверьте return redirect('/notes', 303); в NoteController::store.
  • Тесты проходят, но браузер даёт 419? HTTP-тесты не проверяют реальный CSRF; вернитесь к форме с @csrf и cookie сессии.

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