К содержимому

Laravel Eloquent: настройка и проверка на Ubuntu 24.04

Eloquent это ORM Laravel: каждая таблица получает модель, а запросы пишутся методами PHP. На Ubuntu 24.04 с PHP 8.3 и MySQL 8.0 настройка занимает несколько команд: подключить базу, создать миграции и модели, проверить выборку.

Руководство Laravel 3 мин чтения

01Проверьте установку Laravel

На сервере уже должен быть проект Laravel. Проверьте версию командой php artisan --version. Если команда не найдена, установите Laravel по отдельной инструкции, одной строкой: composer create-project laravel/laravel example.com.

bash
php artisan --version

02Подключите MySQL в.env

Свежий Laravel использует SQLite. Для MySQL в .env задайте DB_CONNECTION=mysql и параметры подключения. Базу и пользователя создайте заранее, например через mysql -u root -p. После правки .env выполните php artisan config:clear, если конфиг уже кэширован.

ini
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.

bash
php artisan make:model Post -m
php artisan migrate

04Опишите таблицу в миграции

Откройте созданный файл миграции и добавьте колонки в метод up(). Например, для таблицы posts нужны заголовок и текст. Метод down() удаляет таблицу при откате. После правки снова выполните php artisan migrate.

php
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.

php
class Post extends Model
{
    protected $fillable = ['title', 'body'];

    public function comments(): HasMany
    {
        return $this->hasMany(Comment::class);
    }
}

06Проверьте выборку через tinker

Команда php artisan tinker открывает консоль с загруженным приложением. Создайте запись через модель и прочитайте её обратно. Если запрос падает с ошибкой подключения, проверьте параметры в .env и доступность MySQL.

bash
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.

php
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.

bash
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: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.