meema / laravel-cloudfront
Easily & quickly integrate your application with AWS CloudFront.
Installs: 54 736
Dependents: 0
Suggesters: 0
Security: 0
Stars: 28
Watchers: 3
Forks: 2
Open Issues: 2
Requires
- php: ^7.4|^8.0
- aws/aws-sdk-php: ^3.163
Requires (Dev)
- orchestra/testbench: ^3.5.0|^3.6.0|^4.0|^5.0|^6.0
- pestphp/pest: ^1.0
- phpunit/phpunit: ^5.0|^6.0|^8.0|^9.3
- vlucas/phpdotenv: ^4.2|^5.3
README
This is a wrapper package for AWS CloudFront. Please note that while this package is used in production environments and is completely functional, it currently only focuses on cache invalidations.
PRs & ideas are more than welcome! ๐๐ผ
๐ก Usage
use Meema\CloudFront\Facades\CloudFront; use Meema\CloudFront\Jobs\InvalidateCache; // run any of the following CloudFront methods: $client = CloudFront::getClient(); // exposes the AWS CloudFront client $paths = ['/some-path.jpg', '/another/path.png']; $result = CloudFront::invalidate($paths, string $distributionId = null); // invalidates everything, which is the equivalent to a item path of `/*`. $result = CloudFront::reset(); $message = CloudFront::getInvalidation(string $invalidationId, string $distributionId = null); $messages = CloudFront::listInvalidations(string $distributionId = null); // it's recommended to invalidate your cache using a job dispatch(new InvalidateCache($path.'*')); // you may want to add a '*'-wildcard at the end of your path if you whitelisted any query parameters
Please note, object invalidations typically take from 60 to 300 seconds to complete. You can check the status of an invalidation by viewing your distribution from the CloudFront console.
๐ Installation
You can install the package via composer:
composer require meema/laravel-cloudfront
The package will automatically register itself.
Next, publish the config file with:
php artisan vendor:publish --provider="Meema\CloudFront\Providers\CloudFrontServiceProvider" --tag="config"
Next, please add the following keys their values to your .env
file.
AWS_ACCESS_KEY_ID=xxxxxxx AWS_SECRET_ACCESS_KEY=xxxxxxx AWS_CLOUDFRONT_DISTRIBUTION_ID=xxxxxxx
The following is the content of the published config file:
return [ /** * IAM Credentials from AWS. */ 'credentials' => [ 'key' => env('AWS_ACCESS_KEY_ID'), 'secret' => env('AWS_SECRET_ACCESS_KEY'), ], 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), /** * Specify the version of the CloudFront API you would like to use. * Please only adjust this value if you know what you are doing. */ 'version' => 'latest', /** * Specify the CloudFront Distribution ID. * Example format: EBCYQAQALNSKL */ 'distribution_id' => env('AWS_CLOUDFRONT_DISTRIBUTION_ID'), ];
๐งช Testing
composer test
๐ Changelog
Please see our releases page for more information on what has changed recently.
๐ช๐ผ Contributing
Please see CONTRIBUTING for details.
๐ Community
For help, discussion about best practices, or any other conversation that would benefit from being searchable:
For casual chit-chat with others using this package:
๐จ Security
Please review our security policy on how to report security vulnerabilities.
๐๐ผ Credits
๐ License
The MIT License (MIT). Please see LICENSE for more information.
Made with โค๏ธ by Meema, Inc.