GitHub | Packagist | Changelog
This bundle is a connector bundle for the relay-blob-bundle to store blob data on the filesystem.
It implements the DatasystemProviderServiceInterface
of the blob bundle.
It can save files to a specific path, rename those files, remove those files, or return short-lived share-links.
You need the DbpRelayBlob bundle installed to make this bundle working, see DbpRelayBlobBundle.
You can install the bundle directly from packagist.org.
composer require dbp/relay-blob-connector-filesystem-bundle
- Add the bundle to your
config/bundles.php
in front ofDbpRelayCoreBundle
:
...
Dbp\Relay\BlobBundle\DbpRelayBlobConnectorFilesystemBundle::class => ['all' => true],
Dbp\Relay\BlobBundle\DbpRelayBlobBundle::class => ['all' => true],
Dbp\Relay\CoreBundle\DbpRelayCoreBundle::class => ['all' => true],
];
If you were using the DBP API Server Template as template for your Symfony application, then this should have already been generated for you.
- Run
composer install
to clear caches
The bundle has multiple configuration values that you can specify in your app, either by hard-coding it, or by referencing an environment variable.
For this create config/packages/dbp_relay_blob_connector_filesystem.yaml
in the app with the following
content:
dbp_relay_blob_connector_filesystem:
path: '%kernel.project_dir%/var/blobFiles' # path where files should be placed
link_url: 'http://localhost:8000/' # base link_url of the api
For more info on bundle configuration see https://symfony.com/doc/current/bundles/configuration.html.
- Install dependencies:
composer install
- Run tests:
composer test
- Run linters:
composer run lint
- Run cs-fixer:
composer run cs-fix
Don't forget you need to pull down your dependencies in your main application if you are installing packages in a bundle.
# updates and installs dependencies of dbp/relay-blob-bundle and dbp/relay-blob-connector-filesystem-bundle
composer update dbp/relay-blob-bundle
composer update dbp/relay-blob-connector-filesystem-bundle
Run this script to migrate the database. Run this script after installation of the bundle and after every update to adapt the database to the new source code.
php bin/console doctrine:migrations:migrate --em=dbp_relay_blob_connector_filesystem_bundle
Returns a binary file response of a sharelink id if the sharelink is valid and it exists
relay:errorId | Status code | Description | relay:errorDetails | Example |
---|---|---|---|---|
blobConnectorFilesystem:no-identifier-set |
400 | No identifier set | message |
|
blobConnectorFilesystem:download-file |
400 | No file with this share id found | message |
|
blob-connector-filesystem:save-file-error |
400 | File could not be uploaded | message |
|
blob-connector-filesystem:generate-sharelink-error |
400 | Sharelink could not generated | message |
|
blob-connector-filesystem:fileshare-not-found |
403 | Fileshare was not found! | message |
|
blob-connector-filesystem:path-not-generated |
500 | Path could not be generated | message |
|
blob-connector-filesystem:sharelink-not-saved |
500 | ShareLink could not be saved! | message |
Blob Connector Filesystem Database cleanup
: This cronjob is for cleanup purposes. It deletes all invalid sharelinks and starts every hour.