steffjenl / laravel-azure-blob-storage
Microsoft Azure Blob Storage integration for Laravel's Storage API
Installs: 94 399
Dependents: 0
Suggesters: 0
Security: 0
Stars: 11
Watchers: 3
Forks: 7
Open Issues: 0
Requires
Requires (Dev)
- php: >=8.0.2
- mockery/mockery: ^1.0
- orchestra/testbench: ^7.0
- phpunit/phpunit: ^9.0
- psy/psysh: ^0.11
- squizlabs/php_codesniffer: ^3.1
README
Microsoft Azure Blob Storage integration for Laravel's Storage API
This package uses the new azure storage blob package and extends the AzureBlobStorageAdapter package for specific Laravel functions. You can also use this on frameworks with Flysystem Filesystem support.
Installation
Install the package using composer when using Laravel 9 and higher:
composer require steffjenl/laravel-azure-blob-storage
Install the package using composer when using Laravel 8 and lower:
composer require steffjenl/laravel-azure-blob-storage:1.0.5
On Laravel versions before 5.5 you also need to add the service provider to config/app.php manually:
SteffjeNL\LaravelAzureBlobStorage\AzureBlobStorageServiceProvider::class,
Then add this to the disks section of config/filesystems.php:
'azure' => [ 'driver' => 'azure', 'local_address' => env('AZURE_STORAGE_LOCAL_ADDRESS', null), 'name' => env('AZURE_STORAGE_NAME'), 'key' => env('AZURE_STORAGE_KEY'), 'container' => env('AZURE_STORAGE_CONTAINER'), 'prefix' => env('AZURE_STORAGE_PREFIX', ''), 'url' => env('AZURE_STORAGE_URL', null), ],
Finally, add the fields AZURE_STORAGE_NAME, AZURE_STORAGE_KEY and AZURE_STORAGE_CONTAINER to your .env file with the appropriate credentials. Then you can set the azure driver as either your default or cloud driver and use it to fetch and retrieve files as usual.
Configuration
If you use a DSN you can enter your DNS address in the AZURE_STORAGE_URL field
If you want to use a prefix so that you always work in a specific folder, you can use the AZURE_STORAGE_PREFIX field
If you want to use Storage Emulator you can set AZURE_STORAGE_LOCAL_ADDRESS to local. If your storage emulator is on an external machine you can change the AZURE_STORAGE_LOCAL_ADDRESS other than local.
When using local the connection string will be UseDevelopmentStorage=true.
Example config for local emulator
AZURE_STORAGE_LOCAL_ADDRESS=local AZURE_STORAGE_NAME=devstoreaccount1 AZURE_STORAGE_KEY=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw== AZURE_STORAGE_CONTAINER=CONTAINER_NAME_HERE
Example config for remote emulator
AZURE_STORAGE_LOCAL_ADDRESS=http://192.168.0.2:10000/devstoreaccount1 AZURE_STORAGE_NAME=devstoreaccount1 AZURE_STORAGE_KEY=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw== AZURE_STORAGE_CONTAINER=CONTAINER_NAME_HERE