Building a cloud-friendly application

Environment variables

getenv('foo');

$_ENV['foo'];

$_ENV['foo']['bar'];

Only ever use getenv()

Platform.sh

Symfony 3

// platform_parameters.php
// Configure the database.
if (getenv('PLATFORM_RELATIONSHIPS')) {
    $dbRelationshipName = 'database';
    $relationships = json_decode(base64_decode(getenv('PLATFORM_RELATIONSHIPS')), true);

    foreach ($relationships[$dbRelationshipName] as $endpoint) {
        if (!empty($endpoint['query']['is_master'])) {
            $container->setParameter('database_driver', 'pdo_'.$endpoint['scheme']);
            $container->setParameter('database_host', $endpoint['host']);
            $container->setParameter('database_port', $endpoint['port']);
            $container->setParameter('database_name', $endpoint['path']);
            $container->setParameter('database_user', $endpoint['username']);
            $container->setParameter('database_password', $endpoint['password']);
            $container->setParameter('database_path', '');
            break;
        }
    }
}
// Set a default unique secret, based on a project-specific entropy value.
if (getenv('PLATFORM_PROJECT_ENTROPY')) {
    $container->setParameter('kernel.secret', getenv('PLATFORM_PROJECT_ENTROPY'));
}

Platform.sh / Symfony 4

composer require platformsh/symfonyflex-bridge

mapPlatformShEnvironment();

function mapPlatformShEnvironment() : void
{
    if (!getenv('PLATFORM_APPLICATION')) {
        return;
    }

    $secret = getenv('APP_SECRET') ?: getenv('PLATFORM_PROJECT_ENTROPY') ?: null;
    setEnvVar('APP_SECRET', $secret);

    $appEnv = getenv('APP_ENV') ?: 'prod';
    setEnvVar('APP_ENV', $appEnv);

    if (!getenv('DATABASE_URL')) {
        mapPlatformShDatabase();
    }
}
// ...

Platform.sh / Laravel

composer require platformsh/laravel-bridge

mapPlatformShEnvironment();

function mapPlatformShEnvironment() : void
{
    if (!getenv('PLATFORM_APPLICATION')) {
        return;
    }

    mapAppUrl();

    $secret = getenv('APP_KEY') ?: getenv('PLATFORM_PROJECT_ENTROPY') ?: null;
    setEnvVar('APP_KEY', $secret);

    $secure_cookie = getenv('SESSION_SECURE_COOKIE') ?: 1;
    setEnvVar('SESSION_SECURE_COOKIE', $secure_cookie);

    if (getenv('PLATFORM_RELATIONSHIPS')) {
        $relationships = json_decode(base64_decode(getenv('PLATFORM_RELATIONSHIPS'), true), true);
        mapPlatformShDatabase('database', $relationships);
        mapPlatformShRedisCache('rediscache', $relationships);
        mapPlatformShRedisSession('redissession', $relationships);
    }
}
// ...

Glue of last resort

composer.json

{
    "autoload": {
        "files": ["extra-bridge.php"]
    }
}

Only works if your app reads env vars...