Laravel observer: пошаговая настройка на Ubuntu 24.04
Observer в Laravel перехватывает события модели: создание, обновление, удаление и другие. Он позволяет вынести побочную логику из контроллеров и моделей в отдельный класс. Настройка занимает несколько минут и проверяется записью в лог.
01Проверьте окружение
Убедитесь, что проект Laravel уже установлен и вы находитесь в его каталоге. Версия Laravel должна быть 11 или выше, потому что регистрация observer через атрибут #[ObservedBy] появилась в Laravel 11. PHP 8.3 из Ubuntu 24.04 подходит для Laravel 13.
cd /var/www/example.com
php artisan --version
02Создайте observer
Команда make:observer генерирует класс в app/Observers. Укажите модель, для которой нужен observer. В примере используется модель Customer, созданная вместе с ресурсом Filament.
php artisan make:observer CustomerObserver --model=Customer
03Добавьте логику в методы observer
Откройте app/Observers/CustomerObserver.php. Методы соответствуют событиям модели: created, updated, deleted. В каждый метод можно добавить запись в лог или отправку уведомления. Не вызывайте в observer методы, которые снова сохраняют модель, иначе получите рекурсию.
<?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
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.
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 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 Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы