Laravel Packages

Managing Encrypted Environment Variables In Laravel With Veil

Published
Managing Encrypted Environment Variables In Laravel With Veil image

Veil is a Laravel package designed to enhance the management of encrypted environment variables in your Laravel or Laravel Zero applications.

By introducing the --only-values flag to Laravel's env:encrypt and env:decrypt Artisan commands, Veil allows for more readable and maintainable .env files by encrypting only the values of sensitive variables, rather than the entire file.

Enhancing Environment File Readability

In standard Laravel applications, encrypting the environment file results in the entire file being transformed into a single encrypted string:

eyJpdiI6ImplT2xTaGRzV... # Long encrypted string

With Veil, you can selectively encrypt only the values of sensitive variables, keeping the rest of the file human-readable:

APP_NAME="My awesome app"
APP_ENV=local
APP_DEBUG=true

SOME_API_KEY=eyJpdiI6ImplT2xTaGRzV...

This approach improves the readability of the .env file and may reduce the need for a separate .env.example file. Veil extends Laravel's existing env:encrypt and env:decrypt commands. To encrypt only the values of environment variables, use the --only-values flag:

php artisan env:encrypt --only-values
php artisan env:decrypt --only-values

By default, when using the --only-values flag, Veil encrypts variables ending with _PASSWORD, _KEY, and _SECRET. You can customize this behavior using the --only option. For example, to encrypt only variables ending with _SECRET and the APP_KEY, run:

php artisan env:encrypt --only-values --only="*_SECRET,APP_KEY"

When decrypting, Veil will leave unencrypted values unchanged.

Learn More

For more information, installation instructions, and source code, visit the Veil GitHub repository.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
UUID Request Input and Migration Failure Events in Laravel 13.42 image

UUID Request Input and Migration Failure Events in Laravel 13.42

Read article
Replay Missed Laravel Scheduled Tasks With Schedule Catchup image

Replay Missed Laravel Scheduled Tasks With Schedule Catchup

Read article
Search Polymorphic Relations and Filament Tables With Laravel Searchable image

Search Polymorphic Relations and Filament Tables With Laravel Searchable

Read article
Laravel Rest Api 3.0: Typed Fields, Metrics, and OpenAPI Docs image

Laravel Rest Api 3.0: Typed Fields, Metrics, and OpenAPI Docs

Read article
Real-Time Inertia Props With Laravel Reverb image

Real-Time Inertia Props With Laravel Reverb

Read article
PhpStorm 2026.3 Adds an Agent Workspace and PHP 8.6 Support image

PhpStorm 2026.3 Adds an Agent Workspace and PHP 8.6 Support

Read article