Download the PHP package sustainable-hustle/astrel-laravel without Composer
On this page you can find all versions of the php package sustainable-hustle/astrel-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sustainable-hustle/astrel-laravel
More information about sustainable-hustle/astrel-laravel
Files in sustainable-hustle/astrel-laravel
Package astrel-laravel
Short Description Integrate Astrel to your Laravel applications.
License MIT
Homepage https://github.com/sustainable-hustle/astrel-laravel
Informations about the package astrel-laravel
✨ Astrel Laravel
Integrate Astrel to your Laravel applications.
Astrel is a remote config orchestration application that enables you to change anything in your apps without touching your code.
🍿 Are you a visual learner? Here a quick video tutorial to help you get started with Astrel and Laravel.
Installation
Install this package via composer.
Add your Astrel API key in your .env
file.
Finally, listen for Astrel's webhooks to clear the cache.
Optionally, publish the astrel
config file.
Basic usage
This package provides a facade you can use to retrieve one or many aspects. An aspect is a key/value pair that you configure and updates directly on your Astrel dashboard.
Alternatively, you may use the astrel
helper method to access the Astrel manager or to access a value directly.
Note that if you'd like to fallback to an environment variable you may also use the astrel_env
helper function like so.
Caching
This package automatically caches all retrieved aspects. This ensure your application does not make API calls every single time a value from Astrel is required.
You may use the flush
and refetch
methods from the Astrel
facade to clear the cache as well as refetching its content immediately.
By default, the cache never expires meaning you will have to manually flush it when necessary. This is because Astrel will send you a webhook whenever something changes so you can flush the cache only when necessary (see section below).
However, if you'd like to customize the cache's lifetime, you may update the cache_lifetime
variable in your config/astrel.php
file.
Clear the cache when receiving a webhook
As mentioned above, you can configure Astrel to send you a webhook whenever any value gets updated. That means you can use this webhook to clear and immediately refetch all of your aspects.
This package provides a helper method webhookRoute
on the Astrel
facade that does just that. Simply add this to your routes file and chain any route configuration you might like.
Additionally, if you're using the default web
middleware group, make sure to disable CSRF verification for that route in the VerifyCsrfToken
middleware.
All versions of astrel-laravel with dependencies
guzzlehttp/guzzle Version ^6.3.1|^7.0.1
illuminate/contracts Version ^7.0|^8.0