Livewire 4 — полное руководство

composer require livewire/livewire:^4.0

php artisan optimize:clear

php artisan livewire:publish --config

// Продолжать генерировать классовые компоненты вместо однофайловых
'make_command' => [
    'type' => 'class',
],

php artisan make:livewire post.create
# resources/views/components/post/⚡create.blade.php

<?php

use Livewire\Component;
use App\Models\Post;
use Livewire\Attributes\Validate;

new class extends Component {
    #[Validate('required|string|min:5|max:180')]
    public string $title = '';

    #[Validate('required|string|min:50')]
    public string $body = '';

    public function save()
    {
        $this->validate();

        Post::create([
            'title'   => $this->title,
            'body'    => $this->body,
            'user_id' => auth()->id(),
        ]);

        $this->reset();

        $this->dispatch('notify', message: 'Пост создан');
    }
};

?>

<div>
    <form wire:submit="save">
        <input type="text" wire:model="title" placeholder="Заголовок">
        @error('title') <span class="error">{{ $message }}</span> @enderror

        <textarea wire:model="body" placeholder="Текст"></textarea>
        @error('body') <span class="error">{{ $message }}</span> @enderror

        <button type="submit">Сохранить</button>
    </form>
</div>

php artisan make:livewire post.create --mfc

<?php

namespace App\Livewire;

use Livewire\Component;

class CreatePost extends Component
{
    public string $title = '';

    public function render()
    {
        return view('livewire.create-post');
    }
}

resources/views/
├── components/
│   ├── ⚡counter.blade.php              → <livewire:counter />
│   ├── post/
│   │   ├── ⚡create.blade.php           → <livewire:post.create />
│   │   └── ⚡index.blade.php            → <livewire:post.index />
│   └── button.blade.php                 (обычный Blade-компонент)
└── pages/
    └── ⚡dashboard.blade.php            → <livewire:pages::dashboard />

{{-- По имени --}}
<livewire:counter />

{{-- Вложенные каталоги через точку --}}
<livewire:post.create />

{{-- С namespace --}}
<livewire:pages::post.create />

{{-- С параметрами --}}
<livewire:post.create :title="$initialTitle" :author="$user" />

use App\Livewire\Dashboard;

// По классу
Route::livewire('/dashboard', Dashboard::class);

// По имени компонента — обычный выбор для view-based компонентов
Route::livewire('/dashboard', 'pages::dashboard')
    ->middleware('auth')
    ->name('dashboard');

'component_layout' => 'layouts::app',

use Livewire\Attributes\Layout;
use Livewire\Attributes\Title;

new class extends Component {
    #[Layout('layouts::app')]
    #[Title('Панель управления')]
    public function render() { /* … */ }
};

new class extends Component {
    public string $name = '';
    public ?int $age = null;
    public array $tags = [];
    public bool $isPublic = false;
};

<?php

use Livewire\Component;
use Livewire\Attributes\Prop;

new class extends Component {
    #[Prop]
    public string $type = 'info';

    #[Prop]
    public bool $dismissible = false;
};

?>

<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>
    {{ $slot }}

    @if ($dismissible)
        <button wire:click="$dispatch('dismiss')">×</button>
    @endif
</div>

<livewire:alert type="warning" dismissible class="mt-4">
    Счёт просрочен.
</livewire:alert>

use App\Models\Order;

new class extends Component {
    public Order $order;
    public string $mode;

    public function mount(Order $order, string $mode = 'compact'): void
    {
        $this->order = $order;
        $this->mode  = $mode;
    }
};

use Livewire\Attributes\Locked;

new class extends Component {
    #[Locked]
    public int $invoiceId;   // клиент не подставит чужой id

    public string $note = '';
};

{{-- Livewire 3 --}}
<input wire:model.blur="title">

{{-- Эквивалент того же поведения в v4 --}}
<input wire:model.live.blur="title">

{{-- Livewire 3: обёртка ловила событие поля --}}
<div wire:model="value">
    <input type="text">
</div>

{{-- Livewire 4: включаем явно --}}
<div wire:model.deep="value">
    <input type="text">
</div>

{{-- По умолчанию отложенно --}}
<input type="text" wire:model="name">

{{-- Запрос на каждое изменение --}}
<input type="text" wire:model.live="search">

{{-- Живой поиск с задержкой --}}
<input type="text" wire:model.live.debounce.400ms="search">

{{-- Вложенные данные --}}
<input wire:model="form.address.city">
<input wire:model="post.title">

new class extends Component {
    public function save()
    {
        $this->validate();
        // …
    }
};

<button wire:click="save">Сохранить</button>

<form wire:submit="save">…</form>

<button wire:click="delete({{ $post->id }})"
        wire:confirm="Удалить пост? Отменить будет нельзя.">Удалить</button>

use Livewire\Attributes\Renderless;

new class extends Component {
    #[Renderless]
    public function incrementViewCount(): void
    {
        $this->post->increment('views');
    }
};

{{-- Или со стороны шаблона --}}
<button type="button" wire:click.renderless="incrementViewCount">Учесть</button>

use Livewire\Attributes\Async;

new class extends Component {
    #[Async]
    public function logInteraction(string $element): void
    {
        Analytics::record($element, auth()->id());
    }
};

<button wire:click.async="logInteraction('cta-hero')">Начать</button>

<button wire:click="$refresh">Обновить</button>
<button wire:click="$set('tab', 'settings')">Настройки</button>
<button wire:click="$toggle('showFilters')">Фильтры</button>
<button wire:click="$dispatch('open-modal', { name: 'create' })">Создать</button>
<button wire:click="$parent.closeModal()">Закрыть</button>

1. Создаётся экземпляр компонента
2. boot()
3. mount($params)
4. booted()
5. render()

 1. Приходит POST /livewire-{hash}/update со snapshot состояния
 2. Проверяется контрольная сумма snapshot
 3. Создаётся экземпляр компонента
 4. boot()
 5. Состояние восстанавливается из snapshot
 6. hydrate() / hydrateFoo()
 7. booted()
 8. updating($prop, $value) / updatingFoo($value)
 9. Свойства получают новые значения
10. updated($prop, $value) / updatedFoo($value)
11. Выполняются действия из очереди
12. rendering() → render() → rendered($view, $html)
13. dehydrate() — состояние пакуется обратно в snapshot
14. Ответ: разметка + effects

new class extends Component {
    public float $price = 0;

    public function boot(): void {}
    public function booted(): void {}
    public function hydrate(): void {}
    public function dehydrate(): void {}

    public function updating(string $property, mixed $value): void {}

    public function updated(string $property, mixed $value): void
    {
        $this->validateOnly($property);
    }

    // Для конкретного свойства
    public function updatedPrice(mixed $value): void
    {
        $this->price = round((float) $value, 2);
    }

    // Для вложенного ключа form.email
    public function updatedFormEmail(mixed $value): void
    {
        $this->form['email'] = strtolower(trim($value));
    }
};

use Livewire\Attributes\Validate;

new class extends Component {
    #[Validate('required|string|min:2|max:80')]
    public string $name = '';

    #[Validate('required|email:rfc,dns')]
    public string $email = '';

    #[Validate('accepted', message: 'Нужно согласие на обработку данных.')]
    public bool $consent = false;

    public function submit(): void
    {
        $data = $this->validate();

        Contact::create($data);

        $this->reset();
    }
};

protected function rules(): array
{
    return [
        'email' => [
            'required',
            'email',
            Rule::unique('users', 'email')->ignore($this->userId),
        ],
        'password' => $this->userId ? 'nullable|min:8|confirmed' : 'required|min:8|confirmed',
    ];
}

<?php

namespace App\Livewire\Forms;

use App\Models\Post;
use Livewire\Attributes\Validate;
use Livewire\Form;

class PostForm extends Form
{
    public ?Post $post = null;

    #[Validate('required|string|min:5|max:180')]
    public string $title = '';

    #[Validate('required|string|min:50')]
    public string $body = '';

    public function setPost(Post $post): void
    {
        $this->post  = $post;
        $this->title = $post->title;
        $this->body  = $post->body;
    }

    public function store(): Post
    {
        $this->validate();

        return Post::create($this->except('post'));
    }

    public function update(): void
    {
        $this->validate();

        $this->post->update($this->except('post'));
    }
}

<?php

use Livewire\Component;
use App\Livewire\Forms\PostForm;

new class extends Component {
    public PostForm $form;

    public function save()
    {
        $this->form->post ? $this->form->update() : $this->form->store();

        $this->redirect(route('posts.index'), navigate: true);
    }
};

?>

<div>
    <form wire:submit="save">
        <input wire:model="form.title">
        @error('form.title') <span>{{ $message }}</span> @enderror

        <textarea wire:model="form.body"></textarea>
        @error('form.body') <span>{{ $message }}</span> @enderror

        <button type="submit">Сохранить</button>
    </form>
</div>

<div x-show="$errors.has('email')" x-text="$errors.first('email')"></div>

@island
    <div>Выручка: {{ $this->revenue }}</div>
@endisland

<?php

use Livewire\Component;
use Livewire\Attributes\Computed;

new class extends Component {
    #[Computed]
    public function revenue()
    {
        return Order::whereMonth('created_at', now()->month)->sum('total');
    }

    #[Computed]
    public function queue()
    {
        return Job::pending()->count();
    }

    #[Computed]
    public function feed()
    {
        return Activity::latest()->take(20)->get();
    }
};

?>

<div>
    @island(name: 'revenue')
        <div class="card">
            <h3>Выручка за месяц</h3>
            <p class="stat">{{ number_format($this->revenue, 2, ',', ' ') }} €</p>
        </div>
    @endisland

    @island(name: 'queue', poll: '5s')
        <div class="card">
            <h3>Задач в очереди</h3>
            <p class="stat">{{ $this->queue }}</p>
        </div>
    @endisland

    @island(name: 'feed', lazy: true)
        @placeholder
            <div class="card skeleton animate-pulse h-64"></div>
        @endplaceholder

        <div class="card">
            @foreach ($this->feed as $activity)
                <div wire:key="activity-{{ $activity->id }}">{{ $activity->summary }}</div>
            @endforeach
        </div>
    @endisland
</div>

@island(name: 'revenue')
    Выручка: {{ $this->revenue }}
@endisland

<button wire:click="$refresh" wire:island="revenue">Обновить выручку</button>

@island(name: 'feed')
    @foreach ($this->posts as $post)
        <article wire:key="post-{{ $post->id }}">{{ $post->title }}</article>
    @endforeach
@endisland

<button wire:click="loadMore" wire:island.append="feed">Показать ещё</button>

<button x-on:click="$wire.$island('feed', { mode: 'append' }).loadMore()">
    Показать ещё
</button>

@island(name: 'queue')
    <div wire:poll.3s>
        Задач в очереди: {{ $this->queue }}
    </div>
@endisland

<livewire:modal>
    <h2>Создать пост</h2>

    <form wire:submit="save">
        <input wire:model="title">
        <button type="submit">Сохранить</button>
    </form>
</livewire:modal>

<?php

use Livewire\Component;

new class extends Component {
    public bool $isOpen = false;

    public function toggle(): void
    {
        $this->isOpen = ! $this->isOpen;
    }
};

?>

<div wire:show="isOpen" class="modal">
    <button wire:click="toggle" class="modal__close">×</button>

    <div class="modal__body">
        {{ $slot }}
    </div>
</div>

<livewire:modal>
    <wire:slot name="header">
        <h2>Создать пост</h2>
    </wire:slot>

    <form wire:submit="save">
        <input wire:model="title">
    </form>

    <wire:slot name="footer">
        <button wire:click="save">Сохранить</button>
        <button wire:click="$parent.close()">Отмена</button>
    </wire:slot>
</livewire:modal>

<div class="modal">
    @if ($header = $slot('header'))
        <div class="modal__header">{{ $header }}</div>
    @endif

    <div class="modal__body">{{ $slot }}</div>

    @if ($footer = $slot('footer'))
        <div class="modal__footer">{{ $footer }}</div>
    @endif
</div>

<?php

use Livewire\Component;
use Livewire\Attributes\Prop;

new class extends Component {
    #[Prop]
    public string $type = 'info';
};

?>

<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>
    {{ $slot }}
</div>

<livewire:alert type="danger" class="mt-6" data-testid="overdue-alert">
    Счёт просрочен на 14 дней.
</livewire:alert>

<div>
    @foreach ($orders as $order)
        <livewire:order-row :order="$order" :key="'order-'.$order->id" />
    @endforeach
</div>

@foreach ($rows as $row)
    <div wire:key="row-{{ $row->id }}">…</div>
@endforeach

use Livewire\Attributes\Reactive;

new class extends Component {
    #[Reactive]
    public int $quantity;
};

<button wire:click="$parent.refreshList()">Обновить список</button>

use Livewire\Attributes\Modelable;

new class extends Component {
    #[Modelable]
    public int $value = 0;
};

<livewire:rating-input wire:model.live="review.rating" />

// Отправка
$this->dispatch('post-created');
$this->dispatch('post-created', postId: $post->id, title: $post->title);
$this->dispatch('refresh')->to(OrderList::class);
$this->dispatch('recalculate')->self();

use Livewire\Attributes\On;

new class extends Component {
    #[On('post-created')]
    public function onPostCreated(int $postId, string $title): void
    {
        // …
    }
};

<button wire:click="$dispatch('open-modal', { name: 'create-order' })">Новый заказ</button>

$this->dispatch('notify', type: 'success', message: 'Заказ сохранён');

<div x-data="{ show: false, message: '' }"
     x-on:notify.window="message = $event.detail.message; show = true; setTimeout(() => show = false, 3000)"
     x-show="show"
     x-transition
     class="toast">
    <span x-text="message"></span>
</div>

use Livewire\Attributes\Computed;

new class extends Component {
    public array $items = [];

    #[Computed]
    public function products()
    {
        return Product::whereIn('id', array_keys($this->items))->get();
    }

    #[Computed]
    public function subtotal(): float
    {
        return $this->products->sum(
            fn ($product) => $product->price * $this->items[$product->id]
        );
    }

    #[Computed]
    public function total(): float
    {
        return round($this->subtotal * 1.2, 2);
    }
};

@island(name: 'totals')
    <p>Сумма: {{ number_format($this->subtotal, 2, ',', ' ') }} €</p>
    <p>Итого с НДС: {{ number_format($this->total, 2, ',', ' ') }} €</p>
@endisland

#[Computed(persist: true, seconds: 300)]
public function statistics(): array
{
    return [
        'orders'  => Order::whereMonth('created_at', now()->month)->count(),
        'revenue' => Order::whereMonth('created_at', now()->month)->sum('total'),
    ];
}

#[Computed(cache: true, key: 'global-stats')]
public function globalStats(): array
{
    return app(StatsService::class)->build();
}

unset($this->products, $this->subtotal, $this->total);

use Livewire\Attributes\Url;
use Livewire\Attributes\Session;

new class extends Component {
    #[Url]
    public string $search = '';

    #[Url(as: 'cat')]
    public ?int $categoryId = null;

    #[Url(except: '')]
    public string $sort = 'popular';

    #[Url(keep: true)]
    public int $perPage = 24;

    #[Url(history: true)]
    public string $tab = 'all';

    #[Session]
    public bool $sidebarCollapsed = false;

    #[Session(key: 'admin.table.density')]
    public string $density = 'comfortable';
};

public function save(): void
{
    $this->validate();

    Setting::updateOrCreate(['key' => 'theme'], ['value' => $this->theme]);

    session()->flash('status', 'Настройки сохранены');
}

@if (session('status'))
    <div class="alert alert-success">{{ session('status') }}</div>
@endif

<?php

use Livewire\Component;
use Livewire\WithFileUploads;
use Livewire\Attributes\Validate;

new class extends Component {
    use WithFileUploads;

    #[Validate('required|image|mimes:jpg,jpeg,png,webp|max:4096')]
    public $avatar;

    public function save(): void
    {
        $this->validate();

        $path = $this->avatar->store('avatars', 'public');

        auth()->user()->update(['avatar_path' => $path]);

        $this->reset('avatar');

        $this->dispatch('notify', message: 'Аватар обновлён');
    }
};

?>

<div>
    <form wire:submit="save">
        <input type="file" wire:model="avatar" accept="image/*">

        <div wire:loading wire:target="avatar">Загружаем…</div>

        @if ($avatar)
            <img src="{{ $avatar->temporaryUrl() }}" alt="Превью" class="preview">
        @endif

        @error('avatar') <p class="error">{{ $message }}</p> @enderror

        <button type="submit" wire:loading.attr="disabled">Сохранить</button>
    </form>
</div>

<div x-data="{ progress: 0, uploading: false }"
     x-on:livewire-upload-start="uploading = true"
     x-on:livewire-upload-finish="uploading = false; progress = 0"
     x-on:livewire-upload-error="uploading = false"
     x-on:livewire-upload-progress="progress = $event.detail.progress">

    <input type="file" wire:model="avatar">

    <div x-show="uploading" class="progress">
        <div class="progress__bar" :style="`width: ${progress}%`"></div>
    </div>
</div>

'temporary_file_upload' => [
    'disk'            => 's3',
    'rules'           => ['file', 'max:12288'],
    'directory'       => 'livewire-tmp',
    'middleware'      => 'throttle:60,1',
    'preview_mimes'   => ['png', 'jpeg', 'jpg', 'webp', 'gif', 'mp4', 'pdf'],
    'max_upload_time' => 5,
],

use Livewire\WithPagination;
use Livewire\Attributes\Url;

new class extends Component {
    use WithPagination;

    #[Url]
    public string $search = '';

    public string $sortField = 'created_at';
    public string $sortDirection = 'desc';

    public function updatedSearch(): void
    {
        $this->resetPage();
    }

    public function sortBy(string $field): void
    {
        if ($this->sortField === $field) {
            $this->sortDirection = $this->sortDirection === 'asc' ? 'desc' : 'asc';
        } else {
            $this->sortField = $field;
            $this->sortDirection = 'asc';
        }

        $this->resetPage();
    }

    public function with(): array
    {
        return [
            'orders' => Order::query()
                ->with('customer')
                ->when($this->search, fn ($q) => $q->where('number', 'like', "%{$this->search}%"))
                ->orderBy($this->sortField, $this->sortDirection)
                ->paginate(25),
        ];
    }
};

<div>
    <input type="search" wire:model.live.debounce.400ms="search">

    @island(name: 'rows')
        @foreach ($orders as $order)
            <div wire:key="order-{{ $order->id }}">{{ $order->number }}</div>
        @endforeach
    @endisland

    <button wire:click="nextPage" wire:island.append="rows">Показать ещё</button>
</div>

<div wire:loading>Загрузка…</div>
<div wire:loading.remove>Содержимое</div>

<button wire:click="save">Сохранить</button>
<span wire:loading wire:target="save">Сохраняем…</span>

<span wire:loading wire:target="save,delete,publish">Обрабатываем…</span>
<div wire:loading wire:target.except="search">Обновляем…</div>

<button wire:click="save" wire:loading.attr="disabled">Сохранить</button>
<button wire:click="save" wire:loading.class="opacity-50 cursor-wait">Сохранить</button>

{{-- Показывать индикатор, только если запрос дольше порога --}}
<div wire:loading.delay>Загрузка…</div>
<div wire:loading.delay.long>Загрузка…</div>

[data-loading] .btn {
    opacity: 0.5;
    pointer-events: none;
}

<input wire:model="title">

<span wire:dirty wire:target="title">Есть несохранённые изменения</span>

<div wire:offline class="banner banner--warn">
    Нет соединения с сервером. Изменения не сохраняются.
</div>

{{-- Переключает видимость через CSS, мгновенно, без round trip --}}
<div wire:show="showModal" class="modal">…</div>

<button wire:click="$toggle('showModal')">Открыть</button>

{{-- Текст следует за свойством на клиенте --}}
<span wire:text="title"></span>

<input wire:model="title">

<textarea wire:model="message" maxlength="280"></textarea>

<span wire:text="message.length"></span> / 280

<span wire:bind:class="message.length > 240 && 'text-red-500'">
    Становится длинно
</span>

<?php

new class extends Component {
    public function save() { /* … */ }
};

?>

<div>
    <button wire:click="save">Сохранить</button>

    {{-- Выполняется исключительно на клиенте --}}
    <button x-on:click="$wire.$js.showToast = true">Показать уведомление</button>
</div>

<ul wire:sort="reorder">
    @foreach ($tasks as $task)
        <li wire:sort:item="{{ $task->id }}" wire:key="task-{{ $task->id }}">
            {{ $task->title }}
        </li>
    @endforeach
</ul>

new class extends Component {
    public function reorder(array $order): void
    {
        foreach ($order as $position => $id) {
            Task::where('id', $id)->update(['position' => $position]);
        }
    }
};

<ul wire:sort="reorder">
    @foreach ($tasks as $task)
        <li wire:sort:item="{{ $task->id }}" wire:key="task-{{ $task->id }}">
            <span wire:sort:handle class="cursor-grab">⠿</span>

            <span>{{ $task->title }}</span>

            {{-- Интерактивные элементы не должны начинать перетаскивание --}}
            <button wire:sort:ignore wire:click="delete({{ $task->id }})">Удалить</button>
        </li>
    @endforeach
</ul>

<div class="board">
    @foreach ($columns as $column)
        <ul wire:sort="moveCard" wire:sort:group="board" wire:key="column-{{ $column->id }}">
            @foreach ($column->cards as $card)
                <li wire:sort:item="{{ $card->id }}" wire:key="card-{{ $card->id }}">
                    {{ $card->title }}
                </li>
            @endforeach
        </ul>
    @endforeach
</div>

<?php

use Livewire\Component;
use Livewire\Attributes\Prop;

new class extends Component {
    #[Prop]
    public string $plan = 'starter';
};

?>

<div class="card">
    <h3 class="title">{{ ucfirst($plan) }}</h3>
    <p class="price">{{ $this->price }} € / месяц</p>
</div>

<style>
    /* Скоупится этим компонентом — никаких глобальных коллизий по .title */
    .card  { border: 1px solid #e4e2da; border-radius: 14px; padding: 24px; }
    .title { font-size: 20px; font-weight: 700; }
    .price { color: #2d6a4f; }
</style>

<style global>
    :root { --brand: #f53004; }
</style>

@script
<script>
    const chart = new Chart(document.getElementById('sales'), {
        type: 'line',
        data: @json($chartData),
    });

    $wire.on('data-updated', ({ points }) => {
        chart.data.datasets[0].data = points;
        chart.update();
    });
</script>
@endscript

{{-- Загрузить стороннюю библиотеку один раз на всю страницу --}}
@assets
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
@endassets

<a href="/orders" wire:navigate>Заказы</a>
<a href="/orders" wire:navigate.hover>Заказы</a>
<a href="/login" wire:navigate.replace>Войти</a>

$this->redirect(route('orders.index'), navigate: true);
$this->redirectRoute('orders.show', ['order' => $order], navigate: true);

<div class="sidebar" wire:navigate:scroll>
    …
</div>

@persist('player')
    <audio src="{{ $currentTrack->url }}" controls></audio>
@endpersist

document.addEventListener('livewire:navigate',   (e) => { /* начали, e.detail.url */ });
document.addEventListener('livewire:navigating', () => { /* прямо перед подменой DOM */ });
document.addEventListener('livewire:navigated',  () => { initThirdPartyWidgets(); });

{{-- Компонент целиком --}}
<livewire:revenue-chart lazy />
<livewire:revenue-chart lazy="on-scroll" />

{{-- Только область --}}
@island(lazy: true)
    @placeholder
        <div class="skeleton animate-pulse h-64"></div>
    @endplaceholder

    <div>{{ $this->expensiveReport }}</div>
@endisland

{{-- Выполнить действие, когда элемент попадёт во вьюпорт --}}
<div wire:intersect="loadMore">…</div>

<div wire:poll>…</div>
<div wire:poll.5s>…</div>
<div wire:poll.10s="refreshQueue">…</div>
<div wire:poll.visible.5s="refreshQueue">…</div>
<div wire:poll.keep-alive.5s>…</div>

<div x-data="{ open: false }">
    <button x-on:click="open = !open">Детали</button>

    <div x-show="open">
        <p x-text="$wire.title"></p>

        <button x-on:click="$wire.title = 'Новый заголовок'">Переименовать</button>
        <button x-on:click="$wire.save()">Сохранить</button>
        <button x-on:click="await $wire.calculate(); open = false">Рассчитать</button>
    </div>
</div>

{{-- Двусторонняя привязка в Alpine --}}
<div x-data="{ query: $wire.entangle('search') }">
    <input x-model="query">
</div>

<livewire:modal wire:ref="modal" />

<button x-on:click="$refs.modal.open()">Открыть модалку</button>

use Livewire\Attributes\Json;

new class extends Component {
    #[Json]
    public function searchSuggestions(string $term): array
    {
        return Product::search($term)->take(5)->pluck('name')->all();
    }
};

<input x-on:input.debounce.300ms="suggestions = await $wire.searchSuggestions($event.target.value)">

document.addEventListener('livewire:init', () => {

    Livewire.interceptRequest(({ options, fail }) => {
        options.headers['X-Tenant'] = window.tenantId;

        fail(({ status, preventDefault }) => {
            if (status === 419) {
                preventDefault();
                window.location.reload();   // истёк CSRF-токен
            }
        });
    });

    Livewire.interceptMessage(({ component, succeed }) => {
        succeed(() => {
            console.debug('компонент обновлён', component.name);
        });
    });
});

// Программный доступ
Livewire.dispatch('refresh-orders');
Livewire.find('component-id').call('save');
Livewire.all().forEach((component) => component.$refresh());

<div wire:ignore>
    <select id="select2-field">…</select>
</div>

<div wire:ignore.self>…</div>

php artisan make:livewire post.create --test
# resources/views/components/post/create.test.php

use Livewire\Livewire;

it('рендерится', function () {
    Livewire::test('post.create')
        ->assertStatus(200);
});

it('валидирует обязательные поля', function () {
    Livewire::test('post.create')
        ->set('title', '')
        ->set('body', 'слишком коротко')
        ->call('save')
        ->assertHasErrors(['title' => 'required']);
});

it('сохраняет корректный пост', function () {
    Livewire::actingAs($user)
        ->test('post.create')
        ->set('title', 'Вполне разумный заголовок')
        ->set('body', str_repeat('Достаточно длинный текст поста. ', 3))
        ->call('save')
        ->assertHasNoErrors()
        ->assertDispatched('notify');

    expect(Post::where('title', 'Вполне разумный заголовок')->exists())->toBeTrue();
});

use App\Livewire\Counter;

it('увеличивает счётчик', function () {
    Livewire::test(Counter::class)
        ->assertSet('count', 0)
        ->call('increment')
        ->assertSet('count', 1);
});

// Загрузка файлов
use Illuminate\Http\UploadedFile;

Livewire::test('avatar-uploader')
    ->set('avatar', UploadedFile::fake()->image('avatar.jpg', 400, 400))
    ->call('save')
    ->assertHasNoErrors();

// Компонент внутри страницы
$this->get('/dashboard')
    ->assertSeeLivewire('pages::dashboard');

public function delete(int $postId): void
{
    $post = Post::findOrFail($postId);

    $this->authorize('delete', $post);

    $post->delete();
}

public function boot(): void
{
    Model::preventLazyLoading(! app()->isProduction());
}

php artisan make:livewire post.create              # однофайловый
php artisan make:livewire post.create --mfc        # многофайловый
php artisan make:livewire post.create --test       # с тестом
php artisan make:livewire pages::dashboard         # с namespace
php artisan livewire:publish --config
php artisan optimize:clear