Laravel

다크 모드

[액션.내장된액션] ExportAction ​

개요 ​

Filament v3.2에서는 행을 CSV 또는 XLSX 파일로 내보낼 수 있는 사전 구축된 액션이 도입되었습니다. 트리거 버튼을 클릭하면, 내보낼 열과 해당 열의 라벨을 지정할 수 있는 모달이 표시됩니다. 이 기능은 작업 배치와 데이터베이스 알림을 사용하므로, Laravel에서 해당 마이그레이션을 퍼블리시해야 합니다. 또한, Filament가 내보내기 정보를 저장하는 데 사용하는 테이블의 마이그레이션도 퍼블리시해야 합니다:

bash
# Laravel 11 이상
php artisan make:queue-batches-table
php artisan make:notifications-table

# Laravel 10
php artisan queue:batches-table
php artisan notifications:table
bash
# 모든 앱
php artisan vendor:publish --tag=filament-actions-migrations
php artisan migrate

PostgreSQL을 사용하는 경우, 알림 마이그레이션의 data 컬럼이 json()을 사용하고 있는지 확인하세요: $table->json('data').

User 모델에 UUID를 사용하는 경우, 알림 마이그레이션의 notifiable 컬럼이 uuidMorphs()를 사용하고 있는지 확인하세요: $table->uuidMorphs('notifiable').

ExportAction을 다음과 같이 사용할 수 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Filament\Actions\ExportAction;

ExportAction::make()
    ->exporter(ProductExporter::class)

이 액션을 테이블 헤더에 추가하고 싶다면, Filament\Tables\Actions\ExportAction을 사용할 수 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Filament\Tables\Actions\ExportAction;
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->headerActions([
            ExportAction::make()
                ->exporter(ProductExporter::class)
        ]);
}

또는, 사용자가 내보낼 행을 선택할 수 있도록 테이블 일괄 액션으로 추가하고 싶다면, Filament\Tables\Actions\ExportBulkAction을 사용할 수 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Filament\Tables\Actions\ExportBulkAction;
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->bulkActions([
            ExportBulkAction::make()
                ->exporter(ProductExporter::class)
        ]);
}

Filament가 각 행을 어떻게 내보낼지 알려주는 "exporter" 클래스를 생성해야 합니다.

내보내기 클래스 생성하기 ​

모델에 대한 내보내기 클래스를 생성하려면, 모델 이름을 전달하여 make:filament-exporter 명령어를 사용할 수 있습니다:

bash
php artisan make:filament-exporter Product

이 명령어는 app/Filament/Exports 디렉터리에 새 클래스를 생성합니다. 이제 내보낼 수 있는 열을 정의해야 합니다.

내보내기 열 자동 생성하기 ​

시간을 절약하고 싶다면, Filament가 모델의 데이터베이스 컬럼을 기반으로 열을 자동으로 생성할 수 있습니다. --generate 옵션을 사용하세요:

bash
php artisan make:filament-exporter Product --generate

내보내기 열 정의하기 ​

내보낼 수 있는 열을 정의하려면, 내보내기 클래스에서 getColumns() 메서드를 오버라이드하여 ExportColumn 객체의 배열을 반환해야 합니다:

php
use Filament\Actions\Exports\ExportColumn;

public static function getColumns(): array
{
    return [
        ExportColumn::make('name'),
        ExportColumn::make('sku')
            ->label('SKU'),
        ExportColumn::make('price'),
    ];
}

내보내기 열의 라벨 커스터마이징하기 ​

각 열의 라벨은 이름에서 자동으로 생성되지만, label() 메서드를 호출하여 오버라이드할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('sku')
    ->label('SKU')

기본 열 선택 상태 설정하기 ​

기본적으로, 사용자가 내보낼 열을 선택할 때 모든 열이 선택되어 있습니다. enabledByDefault() 메서드를 사용하여 열의 기본 선택 상태를 커스터마이징할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('description')
    ->enabledByDefault(false)

열 선택 비활성화하기 ​

기본적으로, 사용자는 내보낼 열을 선택할 수 있습니다. 이 기능을 비활성화하려면 columnMapping(false)를 사용하세요:

php
use App\Filament\Exports\ProductExporter;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->columnMapping(false)

계산된 내보내기 열 상태 ​

때로는 데이터베이스 컬럼에서 직접 읽는 대신, 열의 상태를 계산해야 할 수 있습니다.

state() 메서드에 콜백 함수를 전달하여, $record를 기반으로 해당 열의 반환 상태를 커스터마이징할 수 있습니다:

php
use App\Models\Order;
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('amount_including_vat')
    ->state(function (Order $record): float {
        return $record->amount * (1 + $record->vat_rate);
    })

내보내기 열 값 포맷팅하기 ​

대신, formatStateUsing()에 커스텀 포맷팅 콜백을 전달할 수 있습니다. 이 콜백은 셀의 $state와 선택적으로 Eloquent $record를 받습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('status')
    ->formatStateUsing(fn (string $state): string => __("statuses.{$state}"))

열에 여러 값이 있는 경우, 함수가 각 값에 대해 호출됩니다.

텍스트 길이 제한하기 ​

셀 값의 길이를 limit()으로 제한할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('description')
    ->limit(50)

단어 수 제한하기 ​

셀에 표시되는 words()의 개수를 제한할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('description')
    ->words(10)

접두사 또는 접미사 추가하기 ​

셀 값에 prefix() 또는 suffix()를 추가할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('domain')
    ->prefix('https://')
    ->suffix('.com')

셀에 여러 값 내보내기 ​

기본적으로, 열에 여러 값이 있으면 쉼표로 구분됩니다. 대신 listAsJson() 메서드를 사용하여 JSON 배열로 나열할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('tags')
    ->listAsJson()

관계 데이터 표시하기 ​

"점 표기법"을 사용하여 관계 내의 컬럼에 접근할 수 있습니다. 관계 이름이 먼저 오고, 점, 그리고 표시할 컬럼 이름이 옵니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('author.name')

관계 개수 세기 ​

열에서 관련 레코드의 개수를 세고 싶다면, counts() 메서드를 사용할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('users_count')->counts('users')

이 예시에서, users는 개수를 셀 관계의 이름입니다. 컬럼 이름은 users_count여야 하며, 이는 Laravel에서 사용하는 결과 저장 규칙입니다.

계산 전에 관계에 스코프를 적용하고 싶다면, 메서드에 배열을 전달할 수 있습니다. 키는 관계 이름이고 값은 Eloquent 쿼리에 스코프를 적용하는 함수입니다:

php
use Filament\Actions\Exports\ExportColumn;
use Illuminate\Database\Eloquent\Builder;

ExportColumn::make('users_count')->counts([
    'users' => fn (Builder $query) => $query->where('is_active', true),
])

관계 존재 여부 확인하기 ​

단순히 열에 관련 레코드가 존재하는지 표시하고 싶다면, exists() 메서드를 사용할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('users_exists')->exists('users')

이 예시에서, users는 존재 여부를 확인할 관계의 이름입니다. 컬럼 이름은 users_exists여야 하며, 이는 Laravel에서 사용하는 결과 저장 규칙입니다.

계산 전에 관계에 스코프를 적용하고 싶다면, 메서드에 배열을 전달할 수 있습니다. 키는 관계 이름이고 값은 Eloquent 쿼리에 스코프를 적용하는 함수입니다:

php
use Filament\Actions\Exports\ExportColumn;
use Illuminate\Database\Eloquent\Builder;

ExportColumn::make('users_exists')->exists([
    'users' => fn (Builder $query) => $query->where('is_active', true),
])

관계 집계하기 ​

Filament는 관계 필드를 집계할 수 있는 여러 메서드를 제공합니다. avg(), max(), min(), sum() 등이 있습니다. 예를 들어, 열에 모든 관련 레코드의 필드 평균을 표시하고 싶다면, avg() 메서드를 사용할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('users_avg_age')->avg('users', 'age')

이 예시에서, users는 관계 이름이고, age는 평균을 낼 필드입니다. 컬럼 이름은 users_avg_age여야 하며, 이는 Laravel에서 사용하는 결과 저장 규칙입니다.

계산 전에 관계에 스코프를 적용하고 싶다면, 메서드에 배열을 전달할 수 있습니다. 키는 관계 이름이고 값은 Eloquent 쿼리에 스코프를 적용하는 함수입니다:

php
use Filament\Actions\Exports\ExportColumn;
use Illuminate\Database\Eloquent\Builder;

ExportColumn::make('users_avg_age')->avg([
    'users' => fn (Builder $query) => $query->where('is_active', true),
], 'age')

내보내기 포맷 설정하기 ​

기본적으로, 내보내기 액션은 사용자가 CSV와 XLSX 포맷 중에서 선택할 수 있도록 합니다. ExportFormat enum을 사용하여, 액션의 formats() 메서드에 포맷 배열을 전달해 커스터마이징할 수 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Filament\Actions\Exports\Enums\ExportFormat;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->formats([
        ExportFormat::Csv,
    ])
    // 또는
    ->formats([
        ExportFormat::Xlsx,
    ])
    // 또는
    ->formats([
        ExportFormat::Xlsx,
        ExportFormat::Csv,
    ])

또는, 내보내기 클래스에서 getFormats() 메서드를 오버라이드하여, 해당 내보내기를 사용하는 모든 액션의 기본 포맷을 설정할 수 있습니다:

php
use Filament\Actions\Exports\Enums\ExportFormat;

public function getFormats(): array
{
    return [
        ExportFormat::Csv,
    ];
}

내보내기 쿼리 수정하기 ​

기본적으로, 테이블과 함께 ExportAction을 사용하는 경우, 액션은 테이블의 현재 필터링 및 정렬된 쿼리를 사용하여 데이터를 내보냅니다. 테이블이 없는 경우, 모델의 기본 쿼리를 사용합니다. 내보내기 전에 쿼리 빌더를 수정하려면, 액션의 modifyQueryUsing() 메서드를 사용할 수 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Illuminate\Database\Eloquent\Builder;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->modifyQueryUsing(fn (Builder $query) => $query->where('is_active', true))

이 함수에 옵션 배열인 $options 인자를 주입할 수도 있습니다:

php
use App\Filament\Exports\ProductExporter;
use Illuminate\Database\Eloquent\Builder;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->modifyQueryUsing(fn (Builder $query, array $options) => $query->where('is_active', $options['isActive'] ?? true))

또는, 내보내기 클래스에서 modifyQuery() 메서드를 오버라이드하여, 해당 내보내기를 사용하는 모든 액션의 쿼리를 수정할 수 있습니다:

php
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Relations\MorphTo;

public static function modifyQuery(Builder $query): Builder
{
    return $query->with([
        'purchasable' => fn (MorphTo $morphTo) => $morphTo->morphWith([
            ProductPurchase::class => ['product'],
            ServicePurchase::class => ['service'],
            Subscription::class => ['plan'],
        ]),
    ]);
}

내보내기 파일 시스템 설정하기 ​

저장 디스크 커스터마이징하기 ​

기본적으로, 내보낸 파일은 설정 파일에 정의된 저장 디스크에 업로드됩니다. 기본값은 public입니다. 이 값을 변경하려면 FILAMENT_FILESYSTEM_DISK 환경 변수를 설정하세요.

public 디스크를 사용하는 것은 Filament의 여러 부분에서 좋은 기본값이지만, 내보내기에 사용하면 내보낸 파일이 공개 위치에 저장됩니다. 따라서, 기본 파일 시스템 디스크가 public이고 config/filesystems.php에 local 디스크가 존재한다면, Filament는 내보내기에 local 디스크를 대신 사용합니다. ExportAction이나 내보내기 클래스에서 디스크를 public으로 오버라이드하면, Filament는 해당 디스크를 사용합니다.

운영 환경에서는 내보낸 파일에 대한 무단 접근을 방지하기 위해, s3와 같은 비공개 접근 정책을 가진 디스크를 사용하는 것이 좋습니다.

특정 내보내기에 다른 디스크를 사용하고 싶다면, 액션의 disk() 메서드에 디스크 이름을 전달하세요:

php
ExportAction::make()
    ->exporter(ProductExporter::class)
    ->fileDisk('s3')

모든 내보내기 액션에 대해 한 번에 디스크를 설정하려면, AppServiceProvider와 같은 서비스 프로바이더의 boot() 메서드에서 설정할 수 있습니다:

php
use Filament\Actions\ExportAction;

ExportAction::configureUsing(fn (ExportAction $action) => $action->fileDisk('s3'));

또는, 내보내기 클래스에서 getFileDisk() 메서드를 오버라이드하여 디스크 이름을 반환할 수 있습니다:

php
public function getFileDisk(): string
{
    return 's3';
}

생성된 내보내기 파일은 개발자가 필요에 따라 삭제해야 합니다. Filament는 내보낸 파일을 나중에 다시 다운로드할 수 있도록 삭제하지 않습니다.

내보내기 파일 이름 설정하기 ​

기본적으로, 내보낸 파일은 내보내기의 ID와 타입을 기반으로 생성된 이름을 가집니다. 액션의 fileName() 메서드를 사용하여 파일 이름을 커스터마이징할 수 있습니다:

php
use Filament\Actions\Exports\Models\Export;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->fileName(fn (Export $export): string => "products-{$export->getKey()}.csv")

또는, 내보내기 클래스에서 getFileName() 메서드를 오버라이드하여 문자열을 반환할 수 있습니다:

php

use Filament\Actions\Exports\Models\Export;

public function getFileName(Export $export): string
{
    return "products-{$export->getKey()}.csv";
}

내보내기 옵션 사용하기 ​

내보내기 액션은 사용자가 CSV를 내보낼 때 상호작용할 수 있는 추가 폼 컴포넌트를 렌더링할 수 있습니다. 이는 사용자가 내보내기 동작을 커스터마이징할 수 있도록 할 때 유용합니다. 예를 들어, 사용자가 내보낼 때 특정 열의 포맷을 선택할 수 있도록 하고 싶을 수 있습니다. 이를 위해, 내보내기 클래스의 getOptionsFormComponents() 메서드에서 옵션 폼 컴포넌트를 반환할 수 있습니다:

php
use Filament\Forms\Components\TextInput;

public static function getOptionsFormComponents(): array
{
    return [
        TextInput::make('descriptionLimit')
            ->label('설명 열 내용의 길이 제한')
            ->integer(),
    ];
}

또는, 액션의 options() 메서드를 통해 내보내기에 정적 옵션 세트를 전달할 수 있습니다:

php
ExportAction::make()
    ->exporter(ProductExporter::class)
    ->options([
        'descriptionLimit' => 250,
    ])

이제, 내보내기 클래스 내에서 이러한 옵션 데이터를 사용할 수 있습니다. 예를 들어, formatStateUsing() 내에서 열의 값을 포맷팅할 때 사용할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('description')
    ->formatStateUsing(function (string $state, array $options): string {
        return (string) str($state)->limit($options['descriptionLimit'] ?? 100);
    })

또는, $options 인자가 모든 클로저 함수에 전달되므로, limit() 내에서도 접근할 수 있습니다:

php
use Filament\Actions\Exports\ExportColumn;

ExportColumn::make('description')
    ->limit(fn (array $options): int => $options['descriptionLimit'] ?? 100)

커스텀 사용자 모델 사용하기 ​

기본적으로, exports 테이블에는 user_id 컬럼이 있습니다. 이 컬럼은 users 테이블에 제약이 걸려 있습니다:

php
$table->foreignId('user_id')->constrained()->cascadeOnDelete();

Export 모델에서는 user() 관계가 App\Models\User 모델에 대한 BelongsTo 관계로 정의되어 있습니다. App\Models\User 모델이 존재하지 않거나, 다른 모델을 사용하고 싶다면, 서비스 프로바이더의 register() 메서드에서 새로운 Authenticatable 모델을 컨테이너에 바인딩할 수 있습니다:

php
use App\Models\Admin;
use Illuminate\Contracts\Auth\Authenticatable;

$this->app->bind(Authenticatable::class, Admin::class);

인증 가능한 모델이 users가 아닌 다른 테이블을 사용한다면, 해당 테이블 이름을 constrained()에 전달해야 합니다:

php
$table->foreignId('user_id')->constrained('admins')->cascadeOnDelete();

다형성 사용자 관계 사용하기 ​

여러 사용자 모델과 내보내기를 연관시키고 싶다면, 다형성 MorphTo 관계를 사용할 수 있습니다. 이를 위해, exports 테이블의 user_id 컬럼을 다음과 같이 교체해야 합니다:

php
$table->morphs('user');

그런 다음, 서비스 프로바이더의 boot() 메서드에서 Export::polymorphicUserRelationship()을 호출하여, Export 모델의 user() 관계를 MorphTo 관계로 변경해야 합니다:

php
use Filament\Actions\Exports\Models\Export;

Export::polymorphicUserRelationship();

내보낼 수 있는 최대 행 수 제한하기 ​

서버 과부하를 방지하기 위해, 한 번의 CSV 파일에서 내보낼 수 있는 최대 행 수를 제한할 수 있습니다. 액션의 maxRows() 메서드를 호출하세요:

php
ExportAction::make()
    ->exporter(ProductExporter::class)
    ->maxRows(100000)

내보내기 청크 크기 변경하기 ​

Filament는 CSV를 청크로 나누고, 각 청크를 별도의 큐 작업에서 처리합니다. 기본적으로, 한 번에 100행씩 청크됩니다. 액션의 chunkSize() 메서드를 호출하여 이 값을 변경할 수 있습니다:

php
ExportAction::make()
    ->exporter(ProductExporter::class)
    ->chunkSize(250)

대용량 CSV 파일을 내보낼 때 메모리 또는 타임아웃 문제가 발생한다면, 청크 크기를 줄이는 것이 좋습니다.

CSV 구분자 변경하기 ​

CSV의 기본 구분자는 쉼표(,)입니다. 다른 구분자로 내보내고 싶다면, 내보내기 클래스에서 getCsvDelimiter() 메서드를 오버라이드하여 새로운 구분자를 반환하세요:

php
public static function getCsvDelimiter(): string
{
    return ';';
}

한 글자만 지정할 수 있으며, 그렇지 않으면 예외가 발생합니다.

XLSX 셀 스타일링하기 ​

XLSX 파일의 셀을 스타일링하고 싶다면, 내보내기 클래스에서 getXlsxCellStyle() 메서드를 오버라이드하여 OpenSpout Style 객체를 반환하세요:

php
use OpenSpout\Common\Entity\Style\Style;

public function getXlsxCellStyle(): ?Style
{
    return (new Style())
        ->setFontSize(12)
        ->setFontName('Consolas');
}

XLSX 파일의 헤더 셀에만 다른 스타일을 사용하고 싶다면, 내보내기 클래스에서 getXlsxHeaderCellStyle() 메서드를 오버라이드하여 OpenSpout Style 객체를 반환하세요:

php
use OpenSpout\Common\Entity\Style\CellAlignment;
use OpenSpout\Common\Entity\Style\CellVerticalAlignment;
use OpenSpout\Common\Entity\Style\Color;
use OpenSpout\Common\Entity\Style\Style;

public function getXlsxHeaderCellStyle(): ?Style
{
    return (new Style())
        ->setFontBold()
        ->setFontItalic()
        ->setFontSize(14)
        ->setFontName('Consolas')
        ->setFontColor(Color::rgb(255, 255, 77))
        ->setBackgroundColor(Color::rgb(0, 0, 0))
        ->setCellAlignment(CellAlignment::CENTER)
        ->setCellVerticalAlignment(CellVerticalAlignment::CENTER);
}

내보내기 작업 커스터마이징하기 ​

내보내기를 처리하는 기본 작업은 Filament\Actions\Exports\Jobs\PrepareCsvExport입니다. 이 클래스를 확장하고 메서드를 오버라이드하고 싶다면, 서비스 프로바이더의 register() 메서드에서 원래 클래스를 교체할 수 있습니다:

php
use App\Jobs\PrepareCsvExport;
use Filament\Actions\Exports\Jobs\PrepareCsvExport as BasePrepareCsvExport;

$this->app->bind(BasePrepareCsvExport::class, PrepareCsvExport::class);

또는, 액션의 job() 메서드에 새 작업 클래스를 전달하여 특정 내보내기에 대한 작업을 커스터마이징할 수 있습니다:

php
use App\Jobs\PrepareCsvExport;

ExportAction::make()
    ->exporter(ProductExporter::class)
    ->job(PrepareCsvExport::class)

내보내기 큐 및 커넥션 커스터마이징하기 ​

기본적으로, 내보내기 시스템은 기본 큐와 커넥션을 사용합니다. 특정 내보내기 작업에 사용할 큐를 커스터마이징하려면, 내보내기 클래스에서 getJobQueue() 메서드를 오버라이드하세요:

php
public function getJobQueue(): ?string
{
    return 'exports';
}

특정 내보내기 작업에 사용할 커넥션을 커스터마이징하려면, 내보내기 클래스에서 getJobConnection() 메서드를 오버라이드하세요:

php
public function getJobConnection(): ?string
{
    return 'sqs';
}

내보내기 작업 미들웨어 커스터마이징하기 ​

기본적으로, 내보내기 시스템은 각 내보내기에서 한 번에 하나의 작업만 처리합니다. 이는 서버 과부하를 방지하고, 대용량 내보내기로 인해 다른 작업이 지연되는 것을 막기 위함입니다. 이 기능은 내보내기 클래스의 WithoutOverlapping 미들웨어에 정의되어 있습니다:

php
public function getJobMiddleware(): array
{
    return [
        (new WithoutOverlapping("export{$this->export->getKey()}"))->expireAfter(600),
    ];
}

특정 내보내기 작업에 적용할 미들웨어를 커스터마이징하고 싶다면, 내보내기 클래스에서 이 메서드를 오버라이드할 수 있습니다. 작업 미들웨어에 대한 자세한 내용은 Laravel 문서를 참고하세요.

내보내기 작업 재시도 커스터마이징하기 ​

기본적으로, 내보내기 시스템은 작업을 24시간 동안 재시도합니다. 이는 데이터베이스가 일시적으로 사용 불가한 경우와 같은 문제를 해결할 수 있도록 하기 위함입니다. 이 기능은 내보내기 클래스의 getJobRetryUntil() 메서드에 정의되어 있습니다:

php
use Carbon\CarbonInterface;

public function getJobRetryUntil(): ?CarbonInterface
{
    return now()->addDay();
}

특정 내보내기 작업의 재시도 시간을 커스터마이징하고 싶다면, 내보내기 클래스에서 이 메서드를 오버라이드할 수 있습니다. 작업 재시도에 대한 자세한 내용은 Laravel 문서를 참고하세요.

내보내기 작업 태그 커스터마이징하기 ​

기본적으로, 내보내기 시스템은 각 작업에 내보내기 ID로 태그를 지정합니다. 이를 통해 특정 내보내기와 관련된 모든 작업을 쉽게 찾을 수 있습니다. 이 기능은 내보내기 클래스의 getJobTags() 메서드에 정의되어 있습니다:

php
public function getJobTags(): array
{
    return ["export{$this->export->getKey()}"];
}

특정 내보내기 작업에 적용할 태그를 커스터마이징하고 싶다면, 내보내기 클래스에서 이 메서드를 오버라이드할 수 있습니다.

내보내기 작업 배치 이름 커스터마이징하기 ​

기본적으로, 내보내기 시스템은 작업 배치에 이름을 지정하지 않습니다. 특정 내보내기 작업 배치에 적용할 이름을 커스터마이징하고 싶다면, 내보내기 클래스에서 getJobBatchName() 메서드를 오버라이드할 수 있습니다:

php
public function getJobBatchName(): ?string
{
    return 'product-export';
}

권한 ​

기본적으로, 내보내기를 시작한 사용자만 생성된 파일을 다운로드할 수 있습니다. 권한 로직을 커스터마이징하고 싶다면, ExportPolicy 클래스를 생성하고 AuthServiceProvider에 등록할 수 있습니다:

php
use App\Policies\ExportPolicy;
use Filament\Actions\Exports\Models\Export;

protected $policies = [
    Export::class => ExportPolicy::class,
];

정책의 view() 메서드가 다운로드 접근 권한을 부여하는 데 사용됩니다.

정책을 정의하면, 내보내기를 시작한 사용자만 접근할 수 있도록 하는 기존 로직이 제거된다는 점에 유의하세요. 이 로직을 유지하고 싶다면, 정책에 직접 추가해야 합니다:

php
use App\Models\User;
use Filament\Actions\Exports\Models\Export;

public function view(User $user, Export $export): bool
{
    return $export->user()->is($user);
}

나를 위한 문서 한글화

2025년 ~ 지금까지 😍😎🤩