Скачивание файлов

Скачивание файлов в Livewire работает почти так же, как и в самом Laravel. Как правило, вы можете использовать любую утилиту Laravel для скачивания внутри компонента Livewire, и она будет работать как и ожидается.

Однако под капотом скачивание файлов обрабатывается иначе, чем в стандартном приложении Laravel. При использовании Livewire содержимое файла кодируется в Base64, отправляется на фронтенд и декодируется обратно в бинарный формат для скачивания напрямую с клиента.

Базовое использование

Инициировать скачивание файла в Livewire так же просто, как вернуть стандартный ответ Laravel для скачивания.

Ниже приведен пример компонента show-invoice, который содержит кнопку «Скачать» для скачивания PDF-счета:

resources/views/components/⚡show-invoice.blade.php

<?php

use Livewire\Component;
use App\Models\Invoice;

new class extends Component {
    public Invoice $invoice;

    public function mount(Invoice $invoice)
    {
        $this->invoice = $invoice;
    }

    public function download()
    {
        return response()->download(
            $this->invoice->file_path, 'invoice.pdf'
        );
    }
};

<div>
    <h1>{{ $invoice->title }}</h1>

    <span>{{ $invoice->date }}</span>
    <span>{{ $invoice->amount }}</span>

    <button type="button" wire:click="download">Скачать</button>
</div>

Как и в контроллере Laravel, вы также можете использовать фасад Storage для инициации скачивания:

<?php

public function download()
{
    return Storage::disk('invoices')->download('invoice.csv');
}

Потоковое скачивание

Livewire также поддерживает потоковое скачивание; однако на самом деле оно не является потоковым. Скачивание не инициируется до тех пор, пока содержимое файла не будет собрано и доставлено в браузер:

<?php

public function download()
{
    return response()->streamDownload(function () {
        echo '...'; // Прямой вывод содержимого для скачивания...
    }, 'invoice.pdf');
}

Тестирование скачивания файлов

Livewire также предоставляет метод ->assertFileDownloaded(), позволяющий легко проверить, что файл был скачан с заданным именем:

<?php

use App\Models\Invoice;

public function test_can_download_invoice()
{
    $invoice = Invoice::factory();

    Livewire::test(ShowInvoice::class)
        ->call('download')
        ->assertFileDownloaded('invoice.pdf');
}

Вы также можете проверить, что файл не был скачан, используя метод ->assertNoFileDownloaded():

<?php

use App\Models\Invoice;

public function test_does_not_download_invoice_if_unauthorised()
{
    $invoice = Invoice::factory();

    Livewire::test(ShowInvoice::class)
        ->call('download')
        ->assertNoFileDownloaded();
}