benrowe / laravel-filesystem-url

Provides a url generation service for your configured filesystems

Laravel Filesystem Url

Provides a url generation service for your configured filesystems

This extends from laravel's filesystem config.

Installation

Composer

Simply add a dependency on benrowe/laravel-filesystem-url to your project's composer.json file if you use Composer to manage the dependencies of your project.

{
    "require-dev": {
         "benrowe/laravel-filesystem-url": "*"
    }
}

You can also install this package via the composer command:

composer require 'benrowe/laravel-filesystem-url=*'

Configuration

Service Provider + Facade

Once you've installed the package via composer, you need to register the provided service provider into laravel's provider stack.

Benrowe\Laravel\Url\ServiceProvider::class

Optionally you can register the facade:

'Url' => Benrowe\Laravel\Url\Facade::class,

Filesystem

The url builder uses the existing filesystem config, by extending it with some additional details.

Each disk thats configured can have a url key + associated settings

'local' => [
    'url' => [
        'base' => 'http://localhost',
        'baseSecure' => 'https://localhost', // optional
        'prefix' => 'assets', // optional
        'enabled' => true, //optional
    ]
]

Any filesystems that don't have the url key won't allow a url to be generated (throws an exception).

Usage

The primary method is the url($path, $disk = null, $secure = false)

It can be accessed in the following ways:

Facade

Url::url('path/to/file.jpg', 'local', $forceSecure);
// outputs as http://localhost/assets/path/to/file.jpg

Blade Directive

The package provides a convenient blade directive

@url('path/to/file.jpg', 'diskname')
// the blade directive will trap exceptions if the disk doesn't exist, or is not configured correctly.

Todo

• Dynamic config - ability to get the config for s3 buckets based on other config, api, etc.

laravel-filesystem-url's Issues

not compatible with Laravel 5.2

PHP Fatal error:  Call to undefined method Illuminate\Foundation\Application::bindShared() in vendor/benrowe/laravel-filesystem-url/src/ServiceProvider.php on line 47
PHP Stack trace:
PHP   1. {main}() artisan:0
PHP   2. Illuminate\Foundation\Console\Kernel->handle() artisan:36
PHP   3. Illuminate\Foundation\Console\Kernel->bootstrap() vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php:105
PHP   4. Illuminate\Foundation\Application->bootstrapWith() vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php:219
PHP   5. Illuminate\Foundation\Bootstrap\RegisterProviders->bootstrap() vendor/laravel/framework/src/Illuminate/Foundation/Application.php:203
PHP   6. Illuminate\Foundation\Application->registerConfiguredProviders() vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/RegisterProviders.php:17
PHP   7. Illuminate\Foundation\ProviderRepository->load() vendor/laravel/framework/src/Illuminate/Foundation/Application.php:530
PHP   8. Illuminate\Foundation\Application->register() vendor/laravel/framework/src/Illuminate/Foundation/ProviderRepository.php:74
PHP   9. Benrowe\Laravel\Url\ServiceProvider->register() vendor/laravel/framework/src/Illuminate/Foundation/Application.php:554


  [Symfony\Component\Debug\Exception\FatalErrorException]                   
  Call to undefined method Illuminate\Foundation\Application::bindShared()