PHPackages                             tapp/laravel-aws-secrets-manager - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. tapp/laravel-aws-secrets-manager

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

tapp/laravel-aws-secrets-manager
================================

Use AWS Secrets manager to load environment variables for configuration.

v2.0.0(1y ago)37229.2k↓27%22[3 issues](https://github.com/TappNetwork/laravel-aws-secrets-manager/issues)[1 PRs](https://github.com/TappNetwork/laravel-aws-secrets-manager/pulls)MITPHPPHP ^7.1 || ^7.3 || ^7.4 || ^8.0 || ^8.1 || ^8.3CI passing

Since Dec 6Pushed 8mo ago9 watchersCompare

[ Source](https://github.com/TappNetwork/laravel-aws-secrets-manager)[ Packagist](https://packagist.org/packages/tapp/laravel-aws-secrets-manager)[ Docs](https://github.com/tapp/laravel-aws-secrets-manager)[ RSS](/packages/tapp-laravel-aws-secrets-manager/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (10)Dependencies (4)Versions (7)Used By (0)

AWS Secrets Manager
===================

[](#aws-secrets-manager)

[![Latest Version on Packagist](https://camo.githubusercontent.com/59d2f97fc131b4dec507f8c679f930975811b2a49eff3bd285875455949dc356/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f746170702f6c61726176656c2d6177732d736563726574732d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapp/laravel-aws-secrets-manager)[![Tests Laravel 10](https://github.com/TappNetwork/laravel-aws-secrets-manager/actions/workflows/run-tests-l10.yml/badge.svg)](https://github.com/TappNetwork/laravel-aws-secrets-manager/actions/workflows/run-tests-l10.yml/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/5ae3345dcd1ca0622d07191502a8b91f29038a47291d34f8accf2097e1e54d94/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746170702f6c61726176656c2d6177732d736563726574732d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapp/laravel-aws-secrets-manager)

Manage environment secrets using AWS Secrets Manager.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require tapp/laravel-aws-secrets-manager
```

Publish Config:

```
php artisan vendor:publish --provider="Tapp\LaravelAwsSecretsManager\LaravelAwsSecretsManagerServiceProvider"

```

Usage
-----

[](#usage)

This package will try and load in secrets from AWS Secrets manager in any environment that is in the `enabled-environments` config array. It is recommended that caching is enabled to reduce round trips to AWS Secrets Manager.

Available env values:

```
AWS_DEFAULT_REGION
AWS_SECRETS_TAG_NAME=stage
AWS_SECRETS_TAG_VALUE=production
```

`AWS_SECRETS_TAG_NAME` and `AWS_SECRETS_TAG_VALUE` are used to pull down all the secrets that match the tag key/value.

### Other Environment-based Configuration

[](#other-environment-based-configuration)

#### Enabled environments

[](#enabled-environments)

Specify which environments should have AWS Secrets enabled:

`AWS_SECRETS_ENABLED_ENV=production,staging`

Default: `production`

#### Overwritable Variables Config

[](#overwritable-variables-config)

Specify which variables should be able to overwrite the config using the `AWS_SECRETS_VARIABLES_CONFIGS` key in the `.env` file. The format is a comma-separated list of `ENV_VARIABLE_NAME:CONFIG_KEY` pairs.

For example:

`VARIABLES_CONFIG_KEYS=APP_KEY:app.key,OTHER_KEY:app.other_key`

This setup allows `APP_KEY` to overwrite `app.key` in the config, and `OTHER_KEY` to overwrite `app.other_key`.

Default Behavior: If `AWS_SECRETS_VARIABLES_CONFIGS` is not set or is empty, no variables will be set for config overwriting.

#### Cache Settings

[](#cache-settings)

For example:

```
AWS_SECRETS_CACHE_ENABLED=true
AWS_SECRETS_CACHE_EXPIRY=60
AWS_SECRETS_CACHE_STORE=file

```

### Setting up AWS Secrets

[](#setting-up-aws-secrets)

1. Store New Secret.
2. Select type of secret, one of AWS managed or other.
3. Enter Key/Value, the KEY should match a env variable.
4. Give it a secret name and description
5. Add a tag key/value (stage =&gt; production) is an example if you want to pull down all production secrets.

### Cache the config

[](#cache-the-config)

```
php artisan config:cache

```

### AWS Credentials

[](#aws-credentials)

Since this package utilizes the PHP AWS SDK the following .env values are used or credentials set ~/.aws/credentials.

```
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY

```

[https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide\_credentials.html](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html)

### Key Rotation

[](#key-rotation)

If key rotation is enabled, the most recent next rotation date is cached and if it's in the past we force getting the secrets.

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Steve Williamson](https://github.com/tapp)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Laravel Package Boilerplate
---------------------------

[](#laravel-package-boilerplate)

This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).

Laravel Google App Engine (GAE) Datastore Secret Manager
--------------------------------------------------------

[](#laravel-google-app-engine-gae-datastore-secret-manager)

This package was heavily based off of the GAE package. [laravel-GAE-secret-manager](https://github.com/tommerrett/laravel-GAE-secret-manager).

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance50

Moderate activity, may be stable

Popularity48

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Every ~233 days

Recently: every ~255 days

Total

6

Last Release

504d ago

Major Versions

v0.12 → v1.0.02024-07-24

v1.0.0 → v2.0.02025-02-16

PHP version history (4 changes)v0.9PHP ^7.1 || ^7.3 || ^8.0

v0.10PHP ^7.1 || ^7.3 || ^7.4 || ^8.0

v0.11PHP ^7.1 || ^7.3 || ^7.4 || ^8.0 || ^8.1

v1.0.0PHP ^7.1 || ^7.3 || ^7.4 || ^8.0 || ^8.1 || ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/837400?v=4)[tapp](/maintainers/tapp)[@tapp](https://github.com/tapp)

![](https://avatars.githubusercontent.com/u/7796074?v=4)[Scott Grayson](/maintainers/scottgrayson)[@scottgrayson](https://github.com/scottgrayson)

![](https://avatars.githubusercontent.com/u/413354?v=4)[andreiabohner](/maintainers/andreiabohner)[@andreiabohner](https://github.com/andreiabohner)

![](https://avatars.githubusercontent.com/u/29612767?v=4)[johnwesely](/maintainers/johnwesely)[@johnwesely](https://github.com/johnwesely)

---

Top Contributors

[![swilla](https://avatars.githubusercontent.com/u/304159?v=4)](https://github.com/swilla "swilla (30 commits)")[![cwiggan](https://avatars.githubusercontent.com/u/1569958?v=4)](https://github.com/cwiggan "cwiggan (15 commits)")[![nford](https://avatars.githubusercontent.com/u/19161?v=4)](https://github.com/nford "nford (5 commits)")[![aburakovskiy](https://avatars.githubusercontent.com/u/1153385?v=4)](https://github.com/aburakovskiy "aburakovskiy (5 commits)")[![andreia](https://avatars.githubusercontent.com/u/38911?v=4)](https://github.com/andreia "andreia (3 commits)")[![shonggeok](https://avatars.githubusercontent.com/u/49336541?v=4)](https://github.com/shonggeok "shonggeok (1 commits)")[![teodino93](https://avatars.githubusercontent.com/u/1943125?v=4)](https://github.com/teodino93 "teodino93 (1 commits)")[![JamesFreeman](https://avatars.githubusercontent.com/u/916500?v=4)](https://github.com/JamesFreeman "JamesFreeman (1 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")[![LorenzoRogai](https://avatars.githubusercontent.com/u/1665768?v=4)](https://github.com/LorenzoRogai "LorenzoRogai (1 commits)")[![Null78](https://avatars.githubusercontent.com/u/36310671?v=4)](https://github.com/Null78 "Null78 (1 commits)")

---

Tags

hacktoberfesthacktoberfest2021tapplaravel-aws-secrets-manager

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/tapp-laravel-aws-secrets-manager/health.svg)

```
[![Health](https://phpackages.com/badges/tapp-laravel-aws-secrets-manager/health.svg)](https://phpackages.com/packages/tapp-laravel-aws-secrets-manager)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M203](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
