We've all been there. You're getting a new developer up and running with your Laravel project, and for some reason, it's nothing but 500 errors! It works on your machine... what on earth is going on? You've checked all of the usual suspects; the database exists and migrations have been run.
Hours pass. Confusion mounts. Muttering ensues.
Then suddenly, you facepalm. There's a missing entry in their
.env file. See, more often than not, we forget to keep our
.env.example file up to date because it no longer has any meaningful impact on our development cycle. It's only when this happens that you swear you're going to update it. Perhaps you do, perhaps you don't. But even if you do, likely it will get outdated again.
How does it work?
Envy is not a sync-up between your
.env.example file. See, that has a lot of pitfalls. For starters, you almost never want to actually copy environment values from your
.env, because they tend to contain sensitive information that shouldn't be in version control. Additionally, if you no longer need an environment variable in your project because you delete a config file or remove a package, a simple sync between these two files won't help remove those now outdated variables.
Envy is much smarter. It reads all of your project's config files (or any other files you've configured) and finds calls to the
env function. Then, it compares those calls to what's contained inside your
.env.example file. With that knowledge, it is able to suggest additions or removals for you, so that syncing your environment file with your project is only ever an Artisan command away.
Envy has two Artisan commands:
php artisan envy:sync and
php artisan envy:prune. Sync is designed to insert missing environment variables into your
.env.example file. Prune is designed to remove environment variables that are no longer required.
Don't worry, neither of these commands will make changes without confirmation (unless you pass the
Running in CI
Of course, you'd still have to run these commands to sync everything up, which you may forget to do. To make sure you never miss this again, both Artisan commands provide a
--dry option that will check for required additions or removals and return a failure code if any are found.
Let's take a look at a basic GitHub workflow that would perform this check for you.
1name: Check Environment Variables23on: [pull_request]45jobs:6 envy:7 runs-on: ubuntu-latest89 steps:10 - name: Checkout code11 uses: actions/checkout@v21213 - name: Setup PHP14 uses: shivammathur/setup-php@v215 with:16 php-version: 8.11718 - name: Install Composer dependencies19 run: composer install --prefer-dist --no-interaction2021 - name: Run Envy sync22 run: php artisan envy:sync --dry2324 - name: Run Envy prune25 run: php artisan envy:prune --dry
Pretty straightforward stuff, hey? With this in place (obviously tweaked to your project's requirements), you'd know before any PR is merged if your
.env.example file needs some TLC.
Envy has tons of configuration options, all of which can be customised in
config/envy.php. The Envy docs have extensive documentation on all of the options available to you. One thing I'd like to point out however, is the fact that you can add additional environment files to check. So, if you have a
.env.dusk file, you could add those into the mix to ensure they remain up to date.
One thing to remember is that Envy will only search files in your
config directory for
env calls. This is because you should only use the
env function in your config files, as using it elsewhere will prevent app config caching. However, if you need to add additional directories to search, you may add them here.
1/**2 * Here you should list any config files/directories that you want to be3 * included when looking for calls to `env`. Directories are searched4 * recursively. Feel free to include unpublished vendor configs too.5 */6'config_files' => [7 config_path(),8 base_path('vendor/spatie/laravel-permission/config'),9],
I wanted to take a moment to say how much I enjoyed writing Envy. I built it using the action paradigm, which you can see my Laracon talk on here. It makes use of PHP AST for parsing and creating PHP files, which is always entertaining. It also marks my first time using the excellent Termwind package for styling console applications - you should definitely check it out. Writing HTML for the console is so much nicer and feels immediately familiar.
We put a lot of polish into this one, and we hope it comes through.
Envy is certainly going to help us keep things up to date, and we hope it can help you in your projects too! Go read the docs, check out the source code, and remember to like the project on GitHub if it helps you out!