PHPackages kiranajudiya/laravel-cdn - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. kiranajudiya/laravel-cdn ActiveLibrary[File & Storage](/categories/file-storage) kiranajudiya/laravel-cdn ======================== Content Delivery Network (CDN) Package for Laravel v1.0.x-dev(5y ago)04581MITPHPPHP ^7.2.5 Since Mar 17Pushed 5y ago1 watchersCompare [ Source](https://github.com/kiranajudiya/laravel-cdn)[ Packagist](https://packagist.org/packages/kiranajudiya/laravel-cdn)[ RSS](/packages/kiranajudiya-laravel-cdn/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependencies (8)Versions (2)Used By (0) Laravel8 CDN Assets Manager ##### Content Delivery Network Package for Laravel8 [](#content-delivery-network-package-for-laravel8) The package provides the developer the ability to upload their assets (or any public file) to a CDN with a single artisan command. And then it allows them to switch between the local and the online version of the files. ###### Fork From [vipertecpro/laravelcdn6](https://github.com/vipertecpro/laravelcdn6) [](#fork-from-vipertecprolaravelcdn6) This project has been forked from . All credit for the original work goes there. #### Laravel 7/8 Support [](#laravel-78-support) - Laravel 7/8 is supported, as is package auto-discovery. Highlights ---------- [](#highlights) - Amazon Web Services (AWS) - S3 - DigitalOcean (DO) - Spaces - Artisan command to upload content to CDN - Simple Facade to access CDN assets Installation ------------ [](#installation) #### Via Composer [](#via-composer) Require `kiranajudiya/laravel-cdn` in your project: ``` composer require kiranajudiya/laravel-cdn ``` *If you are using Laravel 5.4 or below, you need to register the service provider:* Laravel 5.4 and below: Add the service provider and facade to `config/app.php`: ``` 'providers' => array( //... KiranAjudiya\laravelCDN\CdnServiceProvider::class, ), ``` ``` 'aliases' => array( //... 'CDN' => KiranAjudiya\laravelCDN\Facades\CdnFacadeAccessor::class ), ``` *If you are using Laravel 5.5, there is no need to register the service provider as this package is automatically discovered.* Publish the package config file: ``` php artisan vendor:publish --provider 'KiranAjudiya\laravelCDN\CdnServiceProvider' ``` Environment Configuration ------------------------- [](#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 [](#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 [](#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 [](#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-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 [](#default-cdn-provider) For now, the only CDN provider available is AwsS3. Although, as DO natively support the AWS API, you can utilise it by also providing the endpoint, please see the cdn.php config for more info. This option cannot be set in '.env'. ``` 'default' => 'AwsS3', ``` ##### CDN Provider Configuration [](#cdn-provider-configuration) ``` 'aws' => [ 's3' => [ 'version' => 'latest', 'region' => '', 'endpoint' => '', // For DO Spaces 'buckets' => [ 'my-backup-bucket' => '*', ] ] ], ``` ###### Multiple Buckets [](#multiple-buckets) ``` 'buckets' => [ 'my-default-bucket' => '*', // 'js-bucket' => ['public/js'], // 'css-bucket' => ['public/css'], // ... ] ``` #### Files & Directories [](#files--directories) ###### Include: [](#include) Specify directories, extensions, files and patterns to be uploaded. ``` 'include' => [ 'directories' => ['public/dist'], 'extensions' => ['.js', '.css', '.yxz'], 'patterns' => ['**/*.coffee'], ], ``` ###### Exclude: [](#exclude) Specify what to be ignored. ``` 'exclude' => [ 'directories' => ['public/uploads'], 'files' => [''], 'extensions' => ['.TODO', '.txt'], 'patterns' => ['src/*', '.idea/*'], 'hidden' => true, // ignore hidden files ], ``` ##### Other Configurations [](#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](http://docs.aws.amazon.com/aws-sdk-php/v3/guide/) Usage ----- [](#usage) You can 'push' your assets to your CDN and you can 'empty' your assets as well using the commands below. #### Push [](#push) Only changed assets are pushed to the CDN. (THanks, ) Upload assets to CDN ``` php artisan cdn:push ``` You can specify a folder upload prefix in the cdn.php config file. Your assets will be uploaded into that folder on S3. #### Load Assets [](#load-assets) Use the facade `CDN` to call the `CDN::asset()` function. *Note: the `asset` works the same as the Laravel 8 `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 ``` *Note: the `elixir` works the same as the Laravel 8 `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: 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 ``` *Note: the `mix` works the same as the Laravel 8 `mix` it loads the mix-manifest.json file from public folder and choose the correct file revision generated by webpack:* ``` {{CDN::mix('/js/main.js')}} // example result: https://js-bucket.s3.amazonaws.com/public/js/main-85cafe36ff.js {{CDN::mix('/css/style.css')}} // example result: https://css-bucket.s3.amazonaws.com/public/css/style-2d558139f2.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 ---- [](#test) To run the tests, run the following command from the project folder. ``` $ ./vendor/bin/phpunit ``` Support ------- [](#support) Please request support or submit issues [via Github](https://github.com/kiranajudiya/laravel-cdn/issues) Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/kiranajudiya/laravel-cdn/blob/master/CONTRIBUTING.md) for details. Security Related Issues ----------------------- [](#security-related-issues) If you discover any security related issues, please email instead of using the issue tracker for faster response. You should open an issue at the same time. License ------- [](#license) The MIT License (MIT). Please see [License File](https://github.com/kiranajudiya/laravel-cdn/blob/master/LICENSE) for more information. ### Health Score 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community5 Small or concentrated contributor base Maturity33 Early-stage or recently created project How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1883d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/17902344?v=4)[Kiran Ajudiya](/maintainers/kiranajudiya)[@kiranajudiya](https://github.com/kiranajudiya) --- Tags laravelamazons3awsuploadcdnaws-s3content delivery networkAssets UploadAWS Cloudfront ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/kiranajudiya-laravel-cdn/health.svg) ``` [![Health](https://phpackages.com/badges/kiranajudiya-laravel-cdn/health.svg)](https://phpackages.com/packages/kiranajudiya-laravel-cdn) ``` ### Alternatives [vinelab/cdn Content Delivery Network (CDN) Package for Laravel 217240.8k1](/packages/vinelab-cdn)[publiux/laravelcdn Content Delivery Network (CDN) Package for Laravel 155230.4k](/packages/publiux-laravelcdn)[aws/aws-sdk-php-laravel A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP. 1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[juhasev/laravelcdn Content Delivery Network (CDN) Package for Laravel 1820.4k](/packages/juhasev-laravelcdn)[unisharp/s3-presigned An AWS S3 package for pre-signed upload purpose in Laravel and PHP. 151.8k](/packages/unisharp-s3-presigned) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)