Laravel Filepond Laravel Package

This beta refactors file uploads and improves chunk handling, especially when using Azure OSS storage.

• Azure uploads stage and commit blocks directly, without downloading and uploading the complete file again.
• Invalid chunk ranges and oversized integer headers are rejected before storage writes, preventing invalid empty chunks from accumulating.
• Temporary uploads still support disk-root paths ('' and '/') and historical server IDs, with path validation and safe deletion.
• Add regression tests and CI for supported PHP and Laravel versions.

Breaking changes

Requires PHP 8.2 or later and Laravel 12 or 13. Laravel 13 requires PHP 8.3 or later. Older PHP and Laravel versions are no longer supported.

For Azure uploads, send the original file's Content-Type when initializing a chunked upload, as shown in the README.

Install

composer require sopamo/laravel-filepond:2.0.0-beta.5

Changes from PR #89.

Full changelog

What's Changed

• Laravel 13 support by @jonnott in https://github.com/Sopamo/laravel-filepond/pull/87

New Contributors

• @jonnott made their first contribution in https://github.com/Sopamo/laravel-filepond/pull/87

Full Changelog: https://github.com/Sopamo/laravel-filepond/compare/v1.5.0...v1.6.0

Switch to still-maintained azure-oss driver

Switch to still-maintained azure-oss driver

Switch to still-maintained azure-oss driver

If using matthewbdaly/laravel-azure-storage as a storage driver, we now use azure's append only blobs for much better upload performance when using chunking.

Breaking changes

When using this driver, you have to update your filepond config to include the Content-Type when initializing a chunked file upload and enable chunkForce:

FilePond.setOptions({
  chunkForce: true, // <-- add this
  server: {
    url: "/filepond/api",
    process: {
      url: "/process",
      headers: (file: File) => {
        // Send the original file name which will be used for chunked uploads
        return {
          "Upload-Name": file.name,
          "X-CSRF-TOKEN": "{{ csrf_token() }}",
          "Content-Type": file.type, // <-- add this
        };
      },
    },
    revert: "/process",
    patch: "?patch=",
    headers: {
      "X-CSRF-TOKEN": "{{ csrf_token() }}",
    },
  },
});

Improve chunked uploads:

• Add ability to send the original file name, which is then used for automatic mime type detection
• Reduce memory usage by streaming chunks to a temporary local file and then streaming the final file to the final storage disk

To use the new mime type detection, update your filepond js config:

FilePond.setOptions({
  server: {
    url: '/filepond/api',
    process: {
      url: "/process",
      headers: (file: File) => {
        // Send the original file name which will be used for chunked uploads
        return {
          "Upload-Name": file.name,
          "X-CSRF-TOKEN": "{{ csrf_token() }}",
        }
      },
    },
    revert: '/process',
    patch: "?patch=",
    headers: {
      'X-CSRF-TOKEN': '{{ csrf_token() }}'
    }
  }
});

What's Changed

• Laravel 10.x Compatibility by @laravel-shift in https://github.com/Sopamo/laravel-filepond/pull/68

New Contributors

• @laravel-shift made their first contribution in https://github.com/Sopamo/laravel-filepond/pull/68

Full Changelog: https://github.com/Sopamo/laravel-filepond/compare/v1.1.1...v1.2.0

What's Changed

• Fix deleteDirectory by @cirolaferrara in https://github.com/Sopamo/laravel-filepond/pull/64
• Fix error on delete method by @ryanito in https://github.com/Sopamo/laravel-filepond/pull/53

New Contributors

• @cirolaferrara made their first contribution in https://github.com/Sopamo/laravel-filepond/pull/64
• @ryanito made their first contribution in https://github.com/Sopamo/laravel-filepond/pull/53

Full Changelog: https://github.com/Sopamo/laravel-filepond/compare/v1.1.0...v1.1.1

What's Changed

• Adding Laravel 9.x support by @ntaylor-86 in https://github.com/Sopamo/laravel-filepond/pull/60

New Contributors

• @ntaylor-86 made their first contribution in https://github.com/Sopamo/laravel-filepond/pull/60

Full Changelog: https://github.com/Sopamo/laravel-filepond/compare/v1.0...v1.1.0

V1 brings support for chunking and PHP 8.

Breaking changes

• The getPathFromServerId no longer returns the full path to the file. Instead, it returns the "disk"-local path. See the updated installation instructions in the readme for a working example.

Breaking changes:

The getPathFromServerId no longer returns the full path to the file. Instead it returns the "disk"-local path. For example:

// Before
/var/www/html/public/storage/filepond/yourFile.jpg
// After
filepond/yourFile.jpg

You have to use Laravel's storage class to access the files now:

$filepond = app(Filepond::class);
$disk = config('filepond.temporary_files_disk');

$filePath = $filepond->getPathFromServerId($serverId);
Storage::disk($disk)->get($filePath); // This returns the file contents as a string

This release allows using PHP 8

This release introduces support for remote disks as temporary file storage! This makes it a lot easier to use in distributed systems. Thanks a lot to @mikemand for the contribution! This release also adds support for Laravel 8.

Add a check to see if an upload request contains a valid file