Laravel Eloquent: настройка и проверка на Ubuntu 24.04
Eloquent это ORM Laravel: каждая таблица получает модель, а запросы пишутся методами PHP. На Ubuntu 24.04 с PHP 8.3 и MySQL 8.0 настройка занимает несколько команд: подключить базу, создать миграции и модели, проверить выборку.
01Проверьте установку Laravel
На сервере уже должен быть проект Laravel. Проверьте версию командой php artisan --version. Если команда не найдена, установите Laravel по отдельной инструкции, одной строкой: composer create-project laravel/laravel example.com.
php artisan --version
02Подключите MySQL в.env
Свежий Laravel использует SQLite. Для MySQL в .env задайте DB_CONNECTION=mysql и параметры подключения. Базу и пользователя создайте заранее, например через mysql -u root -p. После правки .env выполните php artisan config:clear, если конфиг уже кэширован.
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=example
DB_USERNAME=example
DB_PASSWORD=secret
03Создайте миграции и модели
Миграция описывает таблицу, модель даёт доступ к её строкам. Команда php artisan make:model Post -m создаст модель app/Models/Post.php и миграцию в database/migrations. В миграции опишите колонки, затем примените её командой php artisan migrate. На рабочем сервере с APP_ENV=production добавьте --force.
php artisan make:model Post -m
php artisan migrate
04Опишите таблицу в миграции
Откройте созданный файл миграции и добавьте колонки в метод up(). Например, для таблицы posts нужны заголовок и текст. Метод down() удаляет таблицу при откате. После правки снова выполните php artisan migrate.
public function up(): void
{
Schema::create('posts', function (Blueprint $table) {
$table->id();
$table->string('title');
$table->text('body')->nullable();
$table->timestamps();
});
}
05Настройте модель и связи
В модели укажите поля, которые можно заполнять через create(), в свойстве $fillable. Связь с другой таблицей описывается методом, например comments() через hasMany. Обратная связь в модели Comment задаётся методом post() через belongsTo.
class Post extends Model
{
protected $fillable = ['title', 'body'];
public function comments(): HasMany
{
return $this->hasMany(Comment::class);
}
}
06Проверьте выборку через tinker
Команда php artisan tinker открывает консоль с загруженным приложением. Создайте запись через модель и прочитайте её обратно. Если запрос падает с ошибкой подключения, проверьте параметры в .env и доступность MySQL.
php artisan tinker
App\Models\Post::create(['title' => 'Первая запись', 'body' => 'Текст']);
App\Models\Post::first();
07Выведите данные в Blade-шаблоне
Маршрут возвращает шаблон с данными. В routes/web.php получите записи через модель и передайте в view(). В шаблоне resources/views/posts.blade.php выведите заголовок через {{ $post->title }}: Blade экранирует HTML.
Route::get('/posts', function () {
return view('posts', ['posts' => App\Models\Post::all()]);
});
08Проверьте работу на сервере
Запустите встроенный сервер Laravel и откройте адрес в браузере. Команда php artisan serve --host=0.0.0.0 --port=8000 поднимает приложение на порту 8000. Если страница отдаёт 500, смотрите storage/logs/laravel.log. Для проверки маршрутов без браузера используйте php artisan route:list.
php artisan serve --host=0.0.0.0 --port=8000
php artisan route:list
Частые ошибки
-
После
php artisan config:cacheв коде возвращаетсяnullвместо значения из.env.Функция
env()вне файловconfig/после кэширования конфига возвращаетnull. Читайте настройки черезconfig('app.name')или очистите кэш командойphp artisan config:clear. -
Каталоги
storageиbootstrap/cacheпринадлежатwww-data, а команды запускаются от владельца проекта.Владелец файлов проекта это пользователь, который деплоит, а
www-dataпишет только через группу. Выполнитеsudo chown -R $USER:www-data storage bootstrap/cacheиsudo chmod -R ug+rwX storage bootstrap/cache, команды artisan запускайте без sudo. -
php artisan migrateна сервере сAPP_ENV=productionждёт подтверждения и не выполняется.Добавьте флаг
--force:php artisan migrate --force. Без него команда останавливается на вопросе о запуске в рабочем окружении. -
Ошибка
No application encryption key has been specified.при первом запросе.В
.envпустойAPP_KEY. Создайте ключ командойphp artisan key:generate, затем при кэшированном конфиге выполнитеphp artisan config:cache.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем Eloquent отличается от конструктора запросов Laravel?
Eloquent работает через модели: каждая модель связана с таблицей и умеет связи, события и аксессоры. Конструктор запросов (DB::table()) возвращает строки без модели и подходит для простых выборок.
Как создать модель вместе с миграцией?
Команда php artisan make:model Post -m создаёт app/Models/Post.php и файл миграции в database/migrations. Затем опишите колонки в миграции и выполните php artisan migrate.
Почему после php artisan config:cache перестал работать env()?
После кэширования конфига env() вне файлов config/ возвращает null. Значения из .env читайте через config() в коде приложения.
Как проверить, что модель подключена к базе?
Запустите php artisan tinker и выполните App\Models\Post::first(). Если запрос вернул запись или null без ошибки, подключение работает.
Ещё по теме
- Руководство · Laravel PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
- Руководство · Laravel Inertia Laravel: пошаговая настройка на Ubuntu 24.04 Подключите Inertia к Laravel на Ubuntu 24.04: установка пакетов, настройка Vite, создание страницы и проверка через curl и браузер.
Laravel: руководство по установке и настройке: все материалы темы