Weave Code
Laravel Azure File Storage Driver Laravel Package
academe/laravel-azure-file-storage-driver
A Laravel filesystem driver that connects Azure File Storage to Laravel's Storage facade. Add an Azure disk to your config and read, write, and delete files through the same familiar API you use for local and S3 storage.
Azure File Storage filesystem driver for Laravel
Frequently asked questions about Laravel Azure File Storage Driver
- How do I install academe/laravel-azure-file-storage-driver in a Laravel app?
- Install the package with Composer and register its service provider if your Laravel version does not auto-discover it. Then add an Azure disk entry to config/filesystems.php with the storage account, share name, credentials, and network access. Run a compatibility check first because the package's last release was in 2022.
- Which Laravel and PHP versions does this Azure File Storage driver support?
- The assessment notes a last release in 2022 and likely Laravel 8/9-era support, but no maintained compatibility matrix is provided. Check the Composer constraints for Laravel, PHP, Flysystem, and the Azure SDK before installing. Laravel 9+ uses Flysystem 3, so a v2-only adapter is a blocker.
- Does this package work with Laravel 10 and Laravel 11?
- It is not confirmed to work with Laravel 10 or 11, and the stale 2022 release makes incompatibility likely. A time-boxed proof of concept on your exact Laravel and PHP versions is the only reliable answer. If it fails, plan to fork and upgrade Flysystem/Laravel support or choose an alternative.
- How do I configure an Azure Files disk in Laravel's filesystems config?
- Add a disk to config/filesystems.php using the driver name provided by the package, then set the Azure storage account, share name, and credentials through environment variables. Confirm SMB network access, firewall rules, private endpoints, and identity configuration for your Azure cloud. Keep Azure-specific calls behind Laravel's Storage facade so domain code stays portable.
- What Azure authentication methods does the driver support?
- The TPM assessment flags authentication paths as an open question rather than documenting them. Connection string or shared key is the likely baseline, while SAS and managed identity need to be verified in the package source and a proof of concept. Test against the exact Azure cloud and auth model you plan to use.
- Can it stream large files and support directories, metadata, and temporary URLs?
- The assessment lists streaming large files, directory semantics, visibility and permissions, metadata, and temporary URLs or SAS generation as potential functional gaps. Azure Files also has SMB-style locking, permissions, and latency characteristics that differ from Blob behavior. Exercise these cases in the proof of concept before relying on them.
- Is academe/laravel-azure-file-storage-driver production-ready?
- Treat it as high risk for production-critical use: it has about 15 stars, a 2022 last release, a low package score, and thin test coverage. The MIT license lets you fork, but that creates an internal maintenance obligation. Adopt only after a short proof of concept proves compatibility and you accept ownership.
- Should I use Azure Files or Azure Blob for Laravel storage?
- Azure Blob is usually the better fit for typical Laravel media and document storage because it provides object-store behavior and public or temporary URL patterns. Azure Files makes sense only when you need SMB file-share semantics such as shared configuration or lift-and-shift file workloads. An SMB mount plus Laravel's local driver is another option if file-share behavior is required.
- How should I test the Azure Files driver before production migration?
- Use a disposable branch and a non-production Azure Files share, then exercise put, get, delete, list, copy, large-file, stream, and error cases. Pin the package and transitive dependencies, wrap it in an internal adapter, and validate dual reads before cutover. Plan rollback by disk or share and migrate in phases.
- What are the alternatives if this Laravel Azure Files driver is incompatible?
- If the driver is incompatible, you can fork it and upgrade Flysystem/Laravel support, switch to an Azure Blob filesystem driver, or use an SMB-mounted share with Laravel's local driver. Choose based on whether your application truly needs Azure Files SMB semantics or object storage. A fork is viable under MIT but requires documented ownership and maintenance.
Weaver
How can I help you explore Laravel packages today?