Модели в Laravel 11: короткая инструкция для начала

К концу этой инструкции у вас будет модель Post, связанная с таблицей posts, заполненной парой строк, которые вы прочитаете и обновите из кода без единого запроса SQL руками. На чистом Laravel 11 это занимает 20–30 минут вместе с настройкой базы. Мы не будем разбирать, как Eloquent устроен внутри — только шаги, которые дают результат.

Что нужно иметь до начала

Проверьте это заранее, чтобы не упереться в нехватку прав или пакета на середине пути.

• PHP 8.2 или новее — требование Laravel 11. Проверьте: php -v.
• Composer — менеджер пакетов PHP¹. Проверьте: composer --version.
• Готовый проект Laravel 11.x. Если проекта нет, создайте: composer create-project laravel/laravel my-app, затем cd my-app.
• База данных. Для старта проще всего SQLite: файл лежит внутри проекта, ничего ставить не нужно.

Настройте SQLite (самый быстрый вариант)

Откройте файл .env в корне проекта и приведите блок базы к такому виду, лишние строки DB_* удалите или закомментируйте:

DB_CONNECTION=sqlite

Создайте пустой файл базы:

# из корня проекта
touch database/database.sqlite

Проверка: файл database/database.sqlite появился в проекте. В свежем Laravel 11 путь к нему подставляется автоматически, отдельно DB_DATABASE прописывать не нужно.

Шаг за шагом

1. Создайте модель вместе с миграцией. Флаг -m сразу генерирует файл миграции для таблицы.

   php artisan make:model Post -m

   Проверка: в терминале появятся строки INFO Model [app/Models/Post.php] created successfully. и INFO Migration [...] created successfully.

2. Опишите поля таблицы в миграции. Откройте файл в database/migrations/ с датой в имени и словом create_posts_table. Внутри метода up() замените тело функции:

   Schema::create('posts', function (Blueprint $table) {
       $table->id();
       $table->string('title');       // заголовок, строка до 255 символов
       $table->text('body');          // текст поста
       $table->boolean('published')->default(false);
       $table->timestamps();          // created_at и updated_at
   });

   Проверка: файл сохранён, синтаксических ошибок редактор не подсвечивает.

3. Примените миграцию. Команда создаст таблицу posts в базе.

   php artisan migrate

   Проверка: в выводе будет строка вида DONE напротив вашей миграции create_posts_table.

4. Разрешите массовое заполнение полей. По умолчанию Eloquent блокирует запись через массив — это защита от подстановки лишних полей. Откройте app/Models/Post.php и добавьте свойство $fillable:

   <?php
   
   namespace App\Models;
   
   use Illuminate\Database\Eloquent\Model;
   
   class Post extends Model
   {
       // поля, которые можно записывать через массив
       protected $fillable = ['title', 'body', 'published'];
   }

   Проверка: файл сохранён, класс Post наследует Model.

5. Проверьте всё в интерактивной консоли. Tinker запускает код в контексте приложения — удобно, чтобы не писать контроллер ради теста.

   php artisan tinker

   Внутри создайте и прочитайте запись:

   // создать строку в таблице
   $post = App\Models\Post::create([
       'title' => 'Первый пост',
       'body' => 'Текст поста для проверки',
       'published' => true,
   ]);
   
   // прочитать все записи
   App\Models\Post::all();
   
   // найти по id
   App\Models\Post::find(1);

   Проверка: после ::all() Tinker покажет коллекцию с одной записью, у которой заполнены id, title и автоматические created_at/updated_at.

Базовые операции с моделью

Эти четыре действия закрывают большинство задач на старте. Все примеры работают в Tinker и в контроллере одинаково.

Разница между find и findOrFail: первый вернёт null, если строки нет, второй выбросит исключение и отдаст 404 в HTTP-контексте. В контроллере обычно берут второй.

Соглашение об именах — не мелочь. Модель Post сама ищет таблицу posts: единственное число в верхнем регистре превращается во множественное в нижнем. Назовёте модель не так — придётся вручную указывать protected $table, и половина «магии» перестанет работать молча.

Если не получилось

• SQLSTATE[HY000] [14] unable to open database file — файл database/database.sqlite не создан или к нему нет прав. Создайте его командой touch и проверьте, что путь совпадает с настройками.

• Base table or view not found: ... posts — таблицы нет, миграция не применялась. Запустите php artisan migrate. Если сомневаетесь в состоянии базы на учебном проекте — php artisan migrate:fresh пересоздаёт все таблицы с нуля (удаляет данные).

• Add [title] to fillable property to allow mass assignment — вы забыли перечислить поле в $fillable. Добавьте его в массив в модели.

• Изменили миграцию, но столбца в базе нет — migrate не перезапускает уже применённые файлы. Правьте схему и выполняйте php artisan migrate:fresh на учебной базе либо создавайте отдельную миграцию на изменение.

• Class "App\Models\Post" not found в Tinker — опечатка в пространстве имён. В Laravel 11 модели лежат в App\Models, обращайтесь с полным путём или подключите через use.

Что делать дальше

Когда модель читает и пишет, следующий логичный шаг — связи между таблицами: hasMany, belongsTo. Например, у поста может быть автор (User) и много комментариев. Это отдельная тема, и её стоит открывать после того, как одиночная модель работает уверенно. Дальше пригодятся сидеры (php artisan make:seeder) для наполнения базы тестовыми данными и валидация входящих данных в контроллере перед записью. Точные сигнатуры методов связей сверяйте в разделе Eloquent Relationships официальной документации под вашу минорную версию Laravel.