supportbook / ssm-parameters-bundle

v1.1.1 2026-10-27 13:17 UTC

Requires

• php: ^8.0
• async-aws/ssm: ^1.2
• symfony/cache: ^6.0 || ^7.0
• symfony/config: ^6.0 || ^7.0
• symfony/dependency-injection: ^6.0 || ^7.0
• symfony/http-kernel: ^6.0 || ^7.0

MIT

• Supportbook

Published on Packagist.org on 2026-10-27 13:24 UTC

README

Simple bundle for adding support for SSM parameters for a Symfony project

Installation

Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require Supportbook/ssm-parameters-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require Supportbook/ssm-parameters-bundle

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

// config/bundles.php

return [
    // ...
    Supportbook\SsmParametersBundle\SupportbookSsmParametersBundle::class => ['all' => true],
];

Usage

Reference an environment variable that holds the name of an SSM parameter with the ssm: prefix:

# config/packages/lexik_jwt_authentication.yaml
lexik_jwt_authentication:
    public_key: '%env(ssm:JWT_PUBLIC_KEY)%'   # JWT_PUBLIC_KEY=/sb/api-gateway/test/jwt/key/public

The value is fetched (with decryption) and stored in the cache.app pool.

Configuration

# config/packages/supportbook_ssm_parameters.yaml
supportbook_ssm_parameters:
    # Seconds a parameter is cached (default 600). A rotated value in SSM is picked up after this time,
    # also when `cache.app` is shared between deploys (e.g. a database adapter).
    cache_lifetime: 600