2017 © Pedro Peláez
 

library cdn

Content Delivery Network (CDN) Package for Laravel

image

floriankaemo/cdn

Content Delivery Network (CDN) Package for Laravel

  • Tuesday, August 29, 2017
  • by floriankaemo
  • Repository
  • 0 Watchers
  • 1 Stars
  • 120 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 64 Forks
  • 0 Open issues
  • 25 Versions
  • 0 % Grown

The README.md

Laravel CDN Assets Manager

Total Downloads Latest Stable Version Latest Unstable Version Build Status Scrutinizer Code Quality License, (*1)

Content Delivery Network Package for Laravel

The package provides the developer the ability to upload his assets (or any public file) to a CDN with a single artisan command. And then it allows him to switch between the local and the online version of the files., (*2)

Laravel Support

  • For Laravel 5.1 use the latest realease (master).
  • For Laravel 4.2 use the realease v1.0.1 Last suport for L 4.2

Highlights

  • Amazon Web Services - S3
  • Artisan command to upload content to CDN
  • Simple Facade to access CDN assets

Installation

Via Composer

Require vinelab/cdn in your project:, (*3)

composer require vinelab/cdn:*

Since this is a Laravel package we need to register the service provider:, (*4)

Add the service provider to config/app.php:, (*5)

'providers' => array(
     //...
     Vinelab\Cdn\CdnServiceProvider::class,
),

Configuration

Set the Credentials in the .env file., (*6)

Note: you must have an .env file at the project root, to hold your sensitive information., (*7)

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=

Publish the package config file:, (*8)

php artisan vendor:publish vinelab/cdn

You can find it at config/cdn.php, (*9)

Default Provider
'default' => 'AwsS3',
CDN Provider Configuration
'aws' => [

    's3' => [

        'version'   => 'latest',
        'region'    => '',


        'buckets' => [
            'my-backup-bucket' => '*',
        ]
    ]
],
Multiple Buckets
'buckets' => [

    'my-default-bucket' => '*',

    // 'js-bucket' => ['public/js'],
    // 'css-bucket' => ['public/css'],
    // ...
]

Files & Directories

Include:

Specify directories, extensions, files and patterns to be uploaded., (*10)

'include'    => [
    'directories'   => ['public/dist'],
    'extensions'    => ['.js', '.css', '.yxz'],
    'patterns'      => ['**/*.coffee'],
],
Exclude:

Specify what to be ignored., (*11)

'exclude'    => [
    'directories'   => ['public/uploads'],
    'files'         => [''],
    'extensions'    => ['.TODO', '.txt'],
    'patterns'      => ['src/*', '.idea/*'],
    'hidden'        => true, // ignore hidden files
],
URL

Set the CDN URL:, (*12)

'url' => 'https://s3.amazonaws.com',
HTTP

Set the HTTP parameters:, (*13)

'http' => '['verify' => path-to-your-pem-certificate-file]',
Bypass

To load your LOCAL assets for testing or during development, set the bypass option to true:, (*14)

'bypass' => true,
Cloudfront Support
'cloudfront'    => [
    'use' => false,
    'cdn_url' => ''
],
Other Configurations
'acl'           => 'public-read',
'metadata'      => [ ],
'expires'       => gmdate("D, d M Y H:i:s T", strtotime("+5 years")),
'cache-control' => 'max-age=2628000',

You can always refer to the AWS S3 Documentation for more details: aws-sdk-php, (*15)

Usage

Push

Upload assets to CDN, (*16)

php artisan cdn:push

Empty

Delete assets from CDN, (*17)

php artisan cdn:empty

Load Assets

Use the facade Cdn to call the Cdn::asset() function., (*18)

Note: the asset works the same as the Laravel asset it start looking for assets in the public/ directory:, (*19)

{{Cdn::asset('assets/js/main.js')}}        // example result: https://js-bucket.s3.amazonaws.com/public/assets/js/main.js

{{Cdn::asset('assets/css/style.css')}}        // example result: https://css-bucket.s3.amazonaws.com/public/assets/css/style.css

Note: the elixir works the same as the Laravel elixir it loads the manifest.json file from build folder and choose the correct file revision generated by gulp:, (*20)

{{Cdn::elixir('assets/js/main.js')}}        // example result: https://js-bucket.s3.amazonaws.com/public/build/assets/js/main-85cafe36ff.js

{{Cdn::elixir('assets/css/style.css')}}        // example result: https://css-bucket.s3.amazonaws.com/public/build/assets/css/style-2d558139f2.css

To use a file from outside the public/ directory, anywhere in app/ use the Cdn::path() function:, (*21)

{{Cdn::path('private/something/file.txt')}}        // example result: https://css-bucket.s3.amazonaws.com/private/something/file.txt

Test

To run the tests, run the following command from the project folder., (*22)

$ ./vendor/bin/phpunit

Support

On Github, (*23)

Contributing

Please see CONTRIBUTING for details., (*24)

Security

If you discover any security related issues, please email mahmoud@vinelab.com instead of using the issue tracker., (*25)

Credits

Project forked from Vinelab/cdn, (*26)

License

The MIT License (MIT). Please see License File for more information., (*27)

The Versions

29/08 2017

dev-master

9999999-dev

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Florian Bouchet

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

27/06 2017

v1.4.6

1.4.6.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Florian Bouchet

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

30/01 2017

v1.4.5

1.4.5.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

30/06 2016

v1.4.4

1.4.4.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

25/06 2016

v1.4.3

1.4.3.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

15/06 2016

dev-develop

dev-develop

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

27/05 2016

v1.4.1

1.4.1.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

27/05 2016

v1.4.2

1.4.2.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

04/04 2016

v1.4.0

1.4.0.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

21/02 2016

v1.3.0

1.3.0.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

29/06 2015

v1.1.8

1.1.8.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

29/06 2015

v1.2.0

1.2.0.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

27/06 2015

v1.1.7

1.1.7.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel amazon s3 upload aws cdn content delivery network aws s3 assets upload

15/06 2015

v1.1.6

1.1.6.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

27/05 2015

v1.1.5

1.1.5.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

27/05 2015

v1.1.4

1.1.4.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

26/05 2015

v1.1.3

1.1.3.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

24/05 2015

v1.1.2

1.1.2.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

22/05 2015

v1.1.1

1.1.1.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

28/02 2015

v1.1.0

1.1.0.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

26/11 2014

v1.0.1

1.0.1.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

13/10 2014

v1.0.0

1.0.0.0

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

24/09 2014

v1.0.0-beta.3

1.0.0.0-beta3

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

22/09 2014

v1.0.0-beta.2

1.0.0.0-beta2

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan

08/09 2014

v1.0.0-beta.1

1.0.0.0-beta1

Content Delivery Network (CDN) Package for Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel upload cdn artisan