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

Laravel observer: пошаговая настройка на Ubuntu 24.04

Observer в Laravel перехватывает события модели: создание, обновление, удаление и другие. Он позволяет вынести побочную логику из контроллеров и моделей в отдельный класс. Настройка занимает несколько минут и проверяется записью в лог.

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

01Проверьте окружение

Убедитесь, что проект Laravel уже установлен и вы находитесь в его каталоге. Версия Laravel должна быть 11 или выше, потому что регистрация observer через атрибут #[ObservedBy] появилась в Laravel 11. PHP 8.3 из Ubuntu 24.04 подходит для Laravel 13.

bash
cd /var/www/example.com
php artisan --version

02Создайте observer

Команда make:observer генерирует класс в app/Observers. Укажите модель, для которой нужен observer. В примере используется модель Customer, созданная вместе с ресурсом Filament.

bash
php artisan make:observer CustomerObserver --model=Customer

03Добавьте логику в методы observer

Откройте app/Observers/CustomerObserver.php. Методы соответствуют событиям модели: created, updated, deleted. В каждый метод можно добавить запись в лог или отправку уведомления. Не вызывайте в observer методы, которые снова сохраняют модель, иначе получите рекурсию.

php
<?php

namespace App\Observers;

use App\Models\Customer;
use Illuminate\Support\Facades\Log;

class CustomerObserver
{
    public function created(Customer $customer): void
    {
        Log::info('Customer created', ['id' => $customer->id]);
    }

    public function updated(Customer $customer): void
    {
        Log::info('Customer updated', ['id' => $customer->id]);
    }

    public function deleted(Customer $customer): void
    {
        Log::info('Customer deleted', ['id' => $customer->id]);
    }
}

04Зарегистрируйте observer

В Laravel 11 и новее observer подключают атрибутом #[ObservedBy] над классом модели. Откройте app/Models/Customer.php и добавьте атрибут и импорт. Если модель создана в другом пространстве имён, укажите полный путь к observer.

php
<?php

namespace App\Models;

use App\Observers\CustomerObserver;
use Illuminate\Database\Eloquent\Attributes\ObservedBy;
use Illuminate\Database\Eloquent\Model;

#[ObservedBy(CustomerObserver::class)]
class Customer extends Model
{
    protected $fillable = ['name', 'email'];
}

05Проверьте работу observer

Создайте запись через tinker и посмотрите лог. Если в storage/logs/laravel.log появилась строка Customer created, observer работает. Для проверки обновления и удаления выполните соответствующие операции в tinker.

bash
php artisan tinker
App\Models\Customer::create(['name' => 'Test', 'email' => 'test@example.com']);
tail -n 5 storage/logs/laravel.log

Частые ошибки

  • Observer не срабатывает после создания, потому что модель не зарегистрирована.

    Добавьте атрибут #[ObservedBy(CustomerObserver::class)] над классом модели или зарегистрируйте observer в AppServiceProvider::boot() через Customer::observe(CustomerObserver::class).

  • В observer вызывается $customer->save(), и запрос уходит в бесконечный цикл.

    Не сохраняйте модель внутри методов observer. Используйте updateQuietly() или saveQuietly(), если нужно изменить поля без повторного вызова событий.

  • После php artisan optimize изменения в observer не применяются.

    Сбросьте кэш командой php artisan optimize:clear и проверьте, что observer зарегистрирован в модели. Кэш конфигурации не кэширует классы observer, но может скрывать ошибки автозагрузки.

Deploykin

Как это делается в Deploykin

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем observer отличается от события модели?

Событие модели это точка, которую можно слушать. Observer это класс, который группирует обработчики нескольких событий одной модели. Оба подхода можно совмещать.

Можно ли использовать observer для нескольких моделей?

Да, создайте отдельный observer для каждой модели. Один класс может содержать методы для разных моделей, но это усложняет поддержку.

Где Laravel ищет observer по умолчанию?

Команда make:observer создаёт класс в app/Observers. При регистрации через атрибут укажите полное имя класса с пространством имён.

Что делать, если observer не видит изменения полей?

Проверьте, что поля входят в $fillable или $guarded. При массовом заполнении незаполняемые поля не сохраняются, и событие updated не срабатывает.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

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