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

Миграции, модель и проверка

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

Добавим notes в новую SQLite-базу и заменим временный ответ чтением через Eloquent.

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

Миграция создаёт таблицу с id, title, body и временем создания/обновления. Команда make:model Note -m создаёт PHP-класс модели и отдельный файл миграции; make:controller создаёт обработчик. В этом уроке контроллер только читает список. Названия знакомы по notes-php, но это другая база: прежние строки сюда не копируются. Четыре подписанные части примера ниже относятся к разным файлам; переносите каждую только в указанный файл.

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

Миграция
Версионированный файл изменения схемы; php artisan migrate выполняет ещё не применённые шаги.
Eloquent-модель
PHP-класс для строк таблицы. Сгенерированная Note будет читать notes через соглашение об имени.
Контроллер
Класс, который обрабатывает запрос и выбирает ответ; index() получает список и передаёт его шаблону.
Blade
Шаблон с HTML и выражениями {{ ... }}; они выводят название как текст, экранируя специальные символы.

$table->timestamps() добавляет поля created_at и updated_at, которые Laravel будет заполнять при записи. Это новая схема, похожая по смыслу на notes-php, но не импорт его файла. title ограничен 200 символами на уровне столбца; проверка формы появится следующим шагом.

Файл модели app/Models/Note.php пока остаётся сгенерированным: для чтения Note::query() не требуется список разрешённых для массового заполнения полей. Его добавим вместе с записью. @forelse показывает сообщение при пустой таблице; {{ $note->title }} безопасно выводит текст.

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

database/migrations/*_create_notes_table.php — замените Schema::create(...) внутри up():
Schema::create('notes', function (Blueprint $table) {
    $table->id();
    $table->string('title', 200);
    $table->text('body');
    $table->timestamps();
});

app/Http/Controllers/NoteController.php — весь файл:
<?php
namespace App\Http\Controllers;
use App\Models\Note;

class NoteController extends Controller
{
    public function index()
    {
        return view('notes.index', [
            'notes' => Note::query()->orderByDesc('id')->get(),
        ]);
    }

}

resources/views/notes/index.blade.php — весь файл:
<!doctype html>
<html lang="ru">
<head><meta charset="utf-8"><title>Заметки</title></head>
<body>
<h1>Заметки</h1>
<ul>
@forelse ($notes as $note)
    <li>{{ $note->title }}</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']);

Практика

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

  1. В терминале из notes-laravel выполните php artisan make:model Note -m и php artisan make:controller NoteController. Команды должны назвать созданные app/Models/Note.php, app/Http/Controllers/NoteController.php и database/migrations/<время>_create_notes_table.php. Модель пока оставьте созданной командой; не добавляйте user_id, ведь вход пользователей не создан.
  2. В Visual Studio Code найдите единственный файл database/migrations/*_create_notes_table.php. В его методе up() замените только вызов Schema::create(...) первым фрагментом примера, оставив use и метод down() на месте; сохраните Ctrl+S. Выполните php artisan migrate и php artisan migrate:status: миграция create_notes_table должна иметь статус Ran. Не используйте базу WordPress или notes-php/data/notes.sqlite.
  3. Полностью замените app/Http/Controllers/NoteController.php вторым фрагментом. В панели файлов создайте папку resources/views/notes, в ней файл index.blade.php и вставьте третий фрагмент. Полностью замените routes/web.php четвёртым фрагментом. Сохраните все файлы Ctrl+S, затем выполните php -l app/Http/Controllers/NoteController.php и php artisan route:list --path=notes: ожидайте GET|HEAD /notes с NoteController@index.
  4. Запустите php artisan serve --host=127.0.0.1 --port=8001 и во втором терминале Ubuntu выполните curl -i http://127.0.0.1:8001/notes: ожидайте 200 и «Пока пусто». curl -i -X POST http://127.0.0.1:8001/notes пока вернёт 405: сохранение добавим в следующем уроке. Остановите сервер Ctrl+C.

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

Миграция notes выполнена в отдельной базе; GET /notes читает модель через контроллер и показывает пустое состояние. POST /notes ещё не создан.

Если не получилось
  • no such table: notes? Проверьте .env с DB_CONNECTION=sqlite, путь database/database.sqlite и php artisan migrate:status; не создавайте таблицу вручную в старом файле.
  • View [notes.index] not found? Проверьте путь resources/views/notes/index.blade.php, включая папку notes и двойное расширение.
  • В выводе по-прежнему временный текст первого урока? Замените весь routes/web.php и проверьте php artisan route:list --path=notes.

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