Andreas Reinhold / reiniandClaude Opus 4.8
4391ad7fb9
Byproduct of the Laravel 13 upgrade: composer's post-update-cmd runs `artisan boost:update`, and Boost went 2.1.3 to 2.4.x with the update. Refreshes CLAUDE.md and boost.json for the Laravel 13 / Livewire 4 stack, updates the livewire, pest and tailwindcss skills, replaces the developing-with-fortify skill with fortify-development, and adds new laravel-best-practices and octane-development skills. Generated output, not hand-edited. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.6 KiB
Events & Notifications Best Practices
Rely on Event Discovery
Laravel auto-discovers listeners by reading handle(EventType $event) type-hints. No manual registration needed in AppServiceProvider.
Run event:cache in Production Deploy
Event discovery scans the filesystem per-request in dev. Cache it in production: php artisan optimize or php artisan event:cache.
Use ShouldDispatchAfterCommit Inside Transactions
Without it, a queued listener may process before the DB transaction commits, reading data that doesn't exist yet.
class OrderShipped implements ShouldDispatchAfterCommit {}
Always Queue Notifications
Notifications often hit external APIs (email, SMS, Slack). Without ShouldQueue, they block the HTTP response.
class InvoicePaid extends Notification implements ShouldQueue
{
use Queueable;
}
Use afterCommit() on Notifications in Transactions
Same race condition as events — call afterCommit() to delay dispatch until the transaction commits.
$user->notify((new InvoicePaid($invoice))->afterCommit());
Route Notification Channels to Dedicated Queues
Mail and database notifications have different priorities. Use viaQueues() to route them to separate queues.
Use On-Demand Notifications for Non-User Recipients
Avoid creating dummy models to send notifications to arbitrary addresses.
Notification::route('mail', 'admin@example.com')->notify(new SystemAlert());
Implement HasLocalePreference on Notifiable Models
Laravel automatically uses the user's preferred locale for all notifications and mailables — no per-call locale() needed.