Laravel CDN Assets Manager

Latest Stable Version Total Downloads 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.

Fork From Vinelab/cdn

This project has been forked from https://github.com/Vinelab/cdn. All credit for the original work goes there.

Laravel Support

Highlights

Questions

  1. Is this package an alternative to Laravel FileSystem and do they work together?

Installation

Via Composer

Require publiux/laravelcdn in your project:

composer require publiux/laravelcdn

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

Add the service provider to config/app.php:

'providers' => array(
     //...
     Publiux\laravelcdn\CdnServiceProvider::class,
),

Publish the package config file:

php artisan vendor:publish

Environment Configuration

This package can be configured by editing the config/app.php file. Alternatively, you can set many of these options in as environment variables in your '.env' file.

AWS Credentials

Set your AWS Credentials and other settings in the .env file.

Note: you should always have an .env file at the project root, to hold your sensitive information. This file should usually not be committed to your VCS.

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
CDN URL

Set the CDN URL:

'url' => env('CDN_Url', 'https://s3.amazonaws.com'),

This can altered in your '.env' file as follows:

CDN_Url=
Bypass

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

'bypass' => env('CDN_Bypass', false),

This can be altered in your '.env' file as follows:

CDN_Bypass=
Cloudfront Support
'cloudfront'    => [
    'use' => env('CDN_UseCloudFront', false),
    'cdn_url' => env('CDN_CloudFrontUrl', false)
],

This can be altered in your '.env' file as follows:

CDN_UseCloudFront=
CDN_CloudFrontUrl=
Default CDN Provider

For now, the only CDN provider available is AwsS3. This option cannot be set in '.env'.

'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.

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

Specify what to be ignored.

'exclude'    => [
    'directories'   => ['public/uploads'],
    'files'         => [''],
    'extensions'    => ['.TODO', '.txt'],
    'patterns'      => ['src/*', '.idea/*'],
    'hidden'        => true, // ignore hidden files
],
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

Usage

You can 'push' your assets to your CDN and you can 'empty' your assets as well using the commands below.

Push

Only changed assets are pushed to the CDN. (THanks, )

Upload assets to CDN

php artisan cdn:push

Empty

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: 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

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: https://css-bucket.s3.amazonaws.com/private/something/file.txt

Test

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

$ ./vendor/bin/phpunit

Support

Please request support or submit issues via Github

Contributing

Please see CONTRIBUTING for details.

Security Related Issues

If you discover any security related issues, please email publiux@gmail.com instead of using the issue tracker for faster response. You should open an issue at the same time.

Credits

License

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

Changelog

v1.0.3

v1.0.2

v1.0.1