Object Storage Library for live-controls
- PHP 8.0+
- S3 compatible Object Storage Hoster like Contabo or DigitalOcean
None
composer require live-controls/storage
- If you want to use DBDisks, create the migration like this:
php artisan vendor:publish --provider="LiveControls\Storage\StorageServiceProvider" --tag="migrations"
- Add to .env:
OBJECTSTORAGE_ACCESS_KEY_ID=53234123 //Should be the access key id to the storage
OBJECTSTORAGE_SECRET_ACCESS_KEY=0000000 //Should be the secret access key to the storage
OBJECTSTORAGE_DEFAULT_REGION=usc1 //Should match the subdomain in endpoint or url
OBJECTSTORAGE_BUCKET=bucketName //The name of the bucket
OBJECTSTORAGE_URL=https://usc1.contabostorage.com/1234567890:bucketName //The url of the bucket
OBJECTSTORAGE_ENDPOINT=https://usc1.contabostorage.com/ //The endpoint of the bucket
OBJECTSTORAGE_USE_PATH_STYLE_ENDPOINT=true //Needs to be true to work!
- Add to config/filesystems.php:
'disks' => [
...
'objectstorage' => [
'driver' => 's3',
'key' => env('OBJECTSTORAGE_ACCESS_KEY_ID'),
'secret' => env('OBJECTSTORAGE_SECRET_ACCESS_KEY'),
'region' => env('OBJECTSTORAGE_DEFAULT_REGION'),
'bucket' => env('OBJECTSTORAGE_BUCKET'),
'url' => env('OBJECTSTORAGE_URL'),
'endpoint' => env('OBJECTSTORAGE_ENDPOINT'),
'use_path_style_endpoint' => env('OBJECTSTORAGE_USE_PATH_STYLE_ENDPOINT', false),
'throw' => false,
],
]- Publish configuration file with:
php artisan vendor:publish --tag="livecontrols.storage.config"
- Set "storage:disk" to the name of your disk set in Step 2
Todo
- To use it with big files, use fopen($fName, 'r+') and not file_get_contents($fName)
- If you, for whatever reason, need to change the directory separator to something else than a forwards slash, change the "directory_separator" inside the configuration file. But you normally wouldn't want to do this, because it would break the temporaryUrl return value.