PHPackages                             pflorek/aws-paramstore - 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. pflorek/aws-paramstore

ActiveLibrary

pflorek/aws-paramstore
======================

This library reads parameters from AWS Parameter Store. It supports a path prefix, an optional shared context and multiple profiles. Returns an multi dimensional array of string|int|float|bool. Integrates directly with zendframework/zend-config-aggregator.

v3.0.0(6y ago)511.2k—8%1[1 issues](https://github.com/pflorek/php-aws-paramstore/issues)MITPHPPHP &gt;=7.0CI failing

Since Jul 16Pushed 6y ago3 watchersCompare

[ Source](https://github.com/pflorek/php-aws-paramstore)[ Packagist](https://packagist.org/packages/pflorek/aws-paramstore)[ RSS](/packages/pflorek-aws-paramstore/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (3)Versions (8)Used By (0)

PHP AWS Parameter Store Config Provider
=======================================

[](#php-aws-parameter-store-config-provider)

[![Build Status](https://camo.githubusercontent.com/ea4e83482d1cb35bd07c7f61be4751042eb1d5816c684489c88a876833051b14/68747470733a2f2f7472617669732d63692e6f72672f70666c6f72656b2f7068702d6177732d706172616d73746f72652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/pflorek/php-aws-paramstore)[![Coverage Status](https://camo.githubusercontent.com/587a6ca78c8c26aa5f3660cc129918e4bcd8fd8b1a2457a3368aac89be4e5540/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f70666c6f72656b2f7068702d6177732d706172616d73746f72652f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/pflorek/php-aws-paramstore?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/93a632e98dd1999fb92111696a50afc144b358f459a87dca64adffd8cbfd1edb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f70666c6f72656b2f7068702d6177732d706172616d73746f72652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/pflorek/php-aws-paramstore/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/d74a7f48dc87e88df6cb320524ca2021246d763be14e2466630aa21e100e914a/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f762f737461626c65)](https://packagist.org/packages/pflorek/aws-paramstore)[![Total Downloads](https://camo.githubusercontent.com/8a72abaae864db486d2c019931e27da1274385e7b1af75a07b9efefb0860ec3e/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f646f776e6c6f616473)](https://packagist.org/packages/pflorek/aws-paramstore)[![Latest Unstable Version](https://camo.githubusercontent.com/a8f65cdc71cb769b7901bc8490ee782b734d08239bf9f305c590aa3c46f994a4/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f762f756e737461626c65)](https://packagist.org/packages/pflorek/aws-paramstore)[![License](https://camo.githubusercontent.com/5f208b5ebfa5e40f73f764d32f53821690e0b0b459ef832daafb4aa18c039470/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f6c6963656e7365)](https://packagist.org/packages/pflorek/aws-paramstore)[![Monthly Downloads](https://camo.githubusercontent.com/98b11a2d6dc6fb054b64e80098cf097639410f73eef46f16460b9df9ad2b5b49/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f642f6d6f6e74686c79)](https://packagist.org/packages/pflorek/aws-paramstore)[![Daily Downloads](https://camo.githubusercontent.com/ae3538e7ffa7d478d3c2b401b7687aec1fda7ee8187c532878b842d7977bae59/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f642f6461696c79)](https://packagist.org/packages/pflorek/aws-paramstore)[![composer.lock](https://camo.githubusercontent.com/ce1d74ecd33ab4f13bc6d5851817984ae012370f17c6f9ee9a5ecbcd02f712a8/68747470733a2f2f706f7365722e707567782e6f72672f70666c6f72656b2f6177732d706172616d73746f72652f636f6d706f7365726c6f636b)](https://packagist.org/packages/pflorek/aws-paramstore)

This library reads parameters from AWS Parameter Store. It supports a path prefix, an optional shared context and multiple profiles. Returns an multi dimensional array of string|int|float|bool. Integrates directly with zendframework/zend-config-aggregator.

Usage
-----

[](#usage)

```
use Aws\Ssm\SsmClient;
use PFlorek\AwsParameterStore\ConfigProvider;

// Provide bootstrap options
$options = [
    'prefix' => '/path/with/prefix', // required
    'name' => 'application-name', // required
    'profileSeparator' => '_', // default => '_'
    'sharedContext' => 'shared-context', // default => ''
];

// Configure AWS Systems Manager Client
$client = new SsmClient([
    'version' => 'latest',
    'region' => 'eu-central-1',
]);
// Or just pass AWS Client options
$client = [
    'version' => 'latest',
    'region' => 'eu-central-1',
];

// Get provided config with active profiles
$environments = ['test'];

// Create AWS Parameter Store Config Provider
$provider = new ConfigProvider($client, $options, $environments);
$config = $provider();

// e.g. returns
//
//array(1) {
//  ["service"]=>
//  array(3) {
//    ["host"]=>
//    string(5) "mysql"
//    ["port"]=>
//    int(3306)
//    ["enabled"]=>
//    bool(true)
//  }
//}
```

Configuration
-------------

[](#configuration)

parameterrequireddefaultdescriptionprefix*yes**none*The path prefix of the parametersname*yes**none*The application nameprofileSeparator*no***'\_'**The separator between application name and profilesharedContext*no***''**The shared context for application with parameters under the same path prefixExample
-------

[](#example)

Given options:

- prefix := **/path/with/prefix**
- name := **app-name**
- profileSeparator := **\_**
- sharedContext = **shared**
- profiles = **\['common', 'test'\]**

Will search for parameters with path beginning with:

1. /path/with/prefix/shared
2. /path/with/prefix/app-name
3. /path/with/prefix/app-name\_common
4. /path/with/prefix/app-name\_test

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

[](#installation)

Use [Composer](https://getcomposer.org) to install the package:

```
composer require pflorek/aws-paramstore
```

Authors
-------

[](#authors)

- [Patrick Florek](https://github.com/pflorek)

Contribute
----------

[](#contribute)

Contributions are always welcome!

- Report any bugs or issues on the [issue tracker](https://github.com/pflorek/php-aws-paramstore/issues).
- You can download the sources at the package's [Git repository](https://github.com/pflorek/php-aws-paramstore).

License
-------

[](#license)

All contents of this package are licensed under the [MIT license](LICENSE).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.7% of commits — single point of failure

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 ~3 days

Total

7

Last Release

2476d ago

Major Versions

v1.0.4 → v2.0.02019-08-08

v2.0.0 → v3.0.02019-08-08

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13916107?v=4)[Patrick Florek](/maintainers/pflorek)[@pflorek](https://github.com/pflorek)

---

Top Contributors

[![pflorek](https://avatars.githubusercontent.com/u/13916107?v=4)](https://github.com/pflorek "pflorek (22 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

awsconfigparameter-storephpawsec2cloudconfigparameterParameter StoreSystems Manager

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pflorek-aws-paramstore/health.svg)

```
[![Health](https://phpackages.com/badges/pflorek-aws-paramstore/health.svg)](https://phpackages.com/packages/pflorek-aws-paramstore)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k511.3M2.2k](/packages/aws-aws-sdk-php)[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[aws/aws-sdk-php-resources

A resource-oriented API for interacting with AWS services

1381.8M10](/packages/aws-aws-sdk-php-resources)[aws/aws-sdk-php-zf2

Zend Framework 2 Module that allows easy integration the AWS SDK for PHP

104997.5k5](/packages/aws-aws-sdk-php-zf2)[fedemotta/yii2-aws-sdk

This extension provides the AWS SDK integration for the Yii2 framework

15430.4k2](/packages/fedemotta-yii2-aws-sdk)[aws/aws-sdk-php-silex

A simple Silex service provider for including the AWS SDK for PHP.

84624.6k2](/packages/aws-aws-sdk-php-silex)

PHPackages © 2026

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