kinow-io / assets-laravel-aws-manager by kinow-io
forked from Vinelab/cdn

Content Delivery Network (CDN) Package for Laravel
Package Data
Maintainer Username: kinow-io
Maintainer Contact: (Abed Halawi)
Package Create Date: 2017-08-29
Package Last Update: 2018-04-11
Language: PHP
License: MIT
Last Refreshed: 2020-05-24 15:05:11
Package Statistics
Total Downloads: 686
Monthly Downloads: 4
Daily Downloads: 0
Total Stars: 1
Total Watchers: 0
Total Forks: 0
Total Open Issues: 0

Laravel CDN Assets Manager

Total Downloads Latest Stable Version Latest Unstable Version Build Status Scrutinizer Code Quality License

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.

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


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


Via Composer

Require kinow-io/assets-laravel-aws-manager in your project:

composer require kinow-io/assets-laravel-aws-manager:*

Since this is a Laravel package we need to register the service provider:

Add the service provider to config/app.php:

'providers' => array(


Set the Credentials in the .env file.

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


Publish the package config file:

php artisan vendor:publish

You can find it at config/cdn.php

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


Specify directories, extensions, files and patterns to be uploaded.

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

Specify what to be ignored.

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

Set the CDN URL:

'url' => '',

Set the HTTP parameters:

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

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

'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



Upload assets to CDN

php artisan cdn:push


Delete assets from CDN

php artisan cdn:empty

Load Assets

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

Note: the asset works the same as the Laravel asset it start looking for assets in the public/ directory:

{{Cdn::asset('assets/js/main.js')}}        // example result:

{{Cdn::asset('assets/css/style.css')}}        // example result:

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:

{{Cdn::elixir('assets/js/main.js')}}        // example result:

{{Cdn::elixir('assets/css/style.css')}}        // example result:

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

{{Cdn::path('private/something/file.txt')}}        // example result:


To run the tests, run the following command from the project folder.

$ ./vendor/bin/phpunit


On Github


Please see CONTRIBUTING for details.


If you discover any security related issues, please email instead of using the issue tracker.



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