Skip to content

Commit

Permalink
Merge pull request #14723 from filamentphp/export-dynamically-swap-pu…
Browse files Browse the repository at this point in the history
…blic-for-local-disk

Use `local` instead of `public` disk for exports where available
  • Loading branch information
danharrin authored Nov 6, 2024
2 parents 3a5097a + 19f5347 commit 6480eb9
Show file tree
Hide file tree
Showing 4 changed files with 13 additions and 13 deletions.
8 changes: 0 additions & 8 deletions packages/actions/docs/01-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,14 +147,6 @@ Create a new `resources/views/components/layouts/app.blade.php` layout file for
</html>
```

## Deploying to production

### Using a production-ready storage disk

Filament has a storage disk defined in the [configuration](#publishing-configuration), which by default is set to `public`. You can set the `FILAMENT_FILESYSTEM_DISK` environment variable to change this.

The `public` disk, while great for easy local development, is not suitable for production. It does not support file visibility, so features of Filament such as [exports](prebuilt-actions/export) will create public files. In production, you need to use a production-ready disk such as `s3` with a private access policy, to prevent unauthorized access to the exported files.

## Publishing configuration

You can publish the package configuration using the following command (optional):
Expand Down
8 changes: 5 additions & 3 deletions packages/actions/docs/07-prebuilt-actions/09-export.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@ title: Export action

## Overview

> Please note that this feature uses the Filament filesystem to store exported files. The disk used by the Filament filesystem is defined in the [configuration file](../installation#publishing-configuration). By default, the disk is set to `public` for easy local development, so when using Filament exports in production, please make sure that you use a production-ready disk such as `s3` with a private access policy. You may also consider [customizing the storage disk](#customizing-the-storage-disk) for exports only.
Filament v3.2 introduced a prebuilt action that is able to export rows to a CSV or XLSX file. When the trigger button is clicked, a modal asks for the columns that they want to export, and what they should be labeled. This feature uses [job batches](https://laravel.com/docs/queues#job-batching) and [database notifications](../../notifications/database-notifications#overview), so you need to publish those migrations from Laravel. Also, you need to publish the migrations for tables that Filament uses to store information about exports:

```bash
Expand Down Expand Up @@ -380,7 +378,11 @@ public static function modifyQuery(Builder $query): Builder

### Customizing the storage disk

By default, exported files will be uploaded to the storage disk defined in the [configuration file](../installation#publishing-configuration), which is `public` by default. You can set the `FILAMENT_FILESYSTEM_DISK` environment variable to change this. In production, you need to use a production-ready disk such as `s3` with a private access policy, to prevent unauthorized access to the exported files.
By default, exported files will be uploaded to the storage disk defined in the [configuration file](../installation#publishing-configuration), which is `public` by default. You can set the `FILAMENT_FILESYSTEM_DISK` environment variable to change this.

While using the `public` disk a good default for many parts of Filament, using it for exports would result in exported files being stored in a public location. As such, if the default filesystem disk is `public` and a `local` disk exists in your `config/filesystems.php`, Filament will use the `local` disk for exports instead. If you override the disk to be `public` for an `ExportAction` or inside an exporter class, Filament will use that.

In production, you should use a disk such as `s3` with a private access policy, to prevent unauthorized access to the exported files.

If you want to use a different disk for a specific export, you can pass the disk name to the `disk()` method on the action:

Expand Down
8 changes: 7 additions & 1 deletion packages/actions/src/Exports/Exporter.php
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,13 @@ public function getOptions(): array

public function getFileDisk(): string
{
return config('filament.default_filesystem_disk');
$disk = config('filament.default_filesystem_disk');

if (($disk === 'public') && array_key_exists('local', config('filesystems.disks'))) {
return 'local';
}

return $disk;
}

public function getFileName(Export $export): string
Expand Down
2 changes: 1 addition & 1 deletion packages/panels/docs/01-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Learn more about [users](users).

Filament has a storage disk defined in the [configuration](#publishing-configuration), which by default is set to `public`. You can set the `FILAMENT_FILESYSTEM_DISK` environment variable to change this.

The `public` disk, while great for easy local development, is not suitable for production. It does not support file visibility, so features of Filament such as [exports](../actions/prebuilt-actions/export) will create public files. In production, you need to use a production-ready disk such as `s3` with a private access policy, to prevent unauthorized access to the exported files.
The `public` disk, while great for easy local development, is not suitable for production. It does not support file visibility, so features of Filament such as [file uploads](../forms/fields/file-upload) will create public files. In production, you need to use a production-ready disk such as `s3` with a private access policy, to prevent unauthorized access to the uploaded files.

## Publishing configuration

Expand Down

0 comments on commit 6480eb9

Please sign in to comment.