Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/superbalist/laravel4-storage
A filesystem abstraction library for Laravel 4
https://github.com/superbalist/laravel4-storage
flysystem laravel laravel4 laravel4-package laravel4-storage php superbalist
Last synced: 3 months ago
JSON representation
A filesystem abstraction library for Laravel 4
- Host: GitHub
- URL: https://github.com/superbalist/laravel4-storage
- Owner: Superbalist
- License: mit
- Archived: true
- Created: 2016-02-01T12:53:32.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2022-07-12T08:13:45.000Z (over 2 years ago)
- Last Synced: 2024-09-27T18:43:19.986Z (3 months ago)
- Topics: flysystem, laravel, laravel4, laravel4-package, laravel4-storage, php, superbalist
- Language: PHP
- Size: 22.5 KB
- Stars: 4
- Watchers: 38
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# laravel4-storage
A filesystem abstraction library for Laravel 4
[](https://twitter.com/superbalist)
[](https://styleci.io/repos/50839213)
[](LICENSE)
[](https://packagist.org/packages/superbalist/laravel4-storage)
[](https://packagist.org/packages/superbalist/laravel4-storage)
This package brings a filesystem abstraction layer to Laravel 4. This is an organic feature of Laravel 5 which uses the
flysystem package under the hood. Please note that this is not a like-for-like version of the Laravel 5 package and that
there may be suttle differences in configuration and method names. We're looking to make this package identical in a
future major version to make the Laravel 4 -> 5 upgrade less painful.
## Supported Adapters
* Local
* Rackspace (Cloud Files)
* Amazon Web Services (S3)
* Google Cloud
## Installation
```bash
composer require superbalist/laravel4-storage
```
Register the service provider in app.php
```php
'providers' => array(
'Superbalist\Storage\StorageServiceProvider',
)
```
Register the facade in app.php
```php
'aliases' => array(
'Storage' => 'Superbalist\Storage\StorageFacade',
)
```
Create a storage.php config file.
```php
put(...)
|
*/
'default' => 'local',
/*
|--------------------------------------------------------------------------
| Connections
|--------------------------------------------------------------------------
|
| The various connection configs.
|
*/
'connections' => array(
'local' => array(
'adapter' => 'local',
'root_path' => storage_path(),
'public_url_base' => '[[http://a.public.url.to.your.service/storage]]',
),
'rackspace' => array(
'adapter' => 'rackspace',
'store' => 'cloudFiles',
'region' => 'LON',
'container' => '[[insert your cdn container name]]',
),
'gcloud' => array(
'adapter' => 'gcloud',
'bucket' => '[[insert your bucket name]]',
),
),
);
```
Create a services.php config file.
```php
array(
'access_key' => '[[your aws key]]',
'secret_key' => '[[your aws secret]]',
'region' => '[[your aws region]]',
),
/*
|--------------------------------------------------------------------------
| Google Cloud
|--------------------------------------------------------------------------
|
*/
'google_cloud' => array(
'service_account' => '[[your service account]',
'key_file' => '[[path to the p12 key file]]',
'secret' => '[[your secret]]',
'developer_key' => '[[your developer key]]',
),
/*
|--------------------------------------------------------------------------
| Rackspace
|--------------------------------------------------------------------------
|
*/
'rackspace' => array(
'username' => '[[your username]]',
'tenant_name' => '[[your tenant name]]',
'api_key' => '[[your api key]]',
'api_endpoint' => \OpenCloud\Rackspace::UK_IDENTITY_ENDPOINT,
),
);
```
## Usage
Please see http://flysystem.thephpleague.com/api/ for full documentation on the core API.
All functions provided by the core API are available behind the `Storage` facade in Laravel.
```php
use Storage;
// write to a file
Storage::write('path/to/file.txt', 'contents');
// update a file
Storage::update('path/to/file.txt', 'new contents');
// read a file
$contents = Storage::read('path/to/file.txt');
// check if a file exists
$exists = Storage::has('path/to/file.txt');
// delete a file
Storage::delete('path/to/file.txt');
// rename a file
Storage::rename('filename.txt', 'newname.txt');
// copy a file
Storage::copy('filename.txt', 'duplicate.txt');
// specify the storage connection to use
$contents = Storage::connection('rackspace')->listContents();
// get a public url to a file
// this is currently only supported by the local and google cloud adapters
$url = Storage::getPublicUrl('path/to/file.txt');
```