PSR-11 Container

The project uses the PSR-11 container to manage dependencies.

Configuration Structure

The configuration is organized by environment in the config/{environment}/ folders. Each environment can have:

• credentials.env - Environment variables (database connections, API keys, JWT secrets, etc.)
• Numbered PHP files - Dependency injection bindings organized by layer:
  • 01-infrastructure.php - Database, Cache, Logging
  • 02-security.php - JWT, Authentication, CORS
  • 03-api.php - OpenAPI routes, Middleware
  • 04-repositories.php - Repository bindings
  • 05-services.php - Service bindings
  • 06-external.php - External services (Email, etc.)

You must set the APP_ENV environment variable to specify which environment to use.

Example: credentials.env

WEB_SERVER=localhost
DASH_SERVER=localhost
WEB_SCHEMA=http
API_SERVER=localhost
API_SCHEMA=http
DBDRIVER_CONNECTION=mysql://root:mysqlp455w0rd@mysql-container/mydb
EMAIL_CONNECTION=smtp://username:[email protected]
JWT_SECRET=your_secret_key_here
CORS_SERVERS=.*

Example: 01-infrastructure.php

<?php

use ByJG\Cache\Psr16\BaseCacheEngine;
use ByJG\Cache\Psr16\NoCacheEngine;
use ByJG\Config\DependencyInjection as DI;
use ByJG\Config\Param;

return [
    BaseCacheEngine::class => DI::bind(NoCacheEngine::class)->toSingleton(),

    DbDriverInterface::class => DI::bind(Factory::class)
        ->withFactoryMethod("getDbRelationalInstance", [Param::get('DBDRIVER_CONNECTION')])
        ->toSingleton(),
];

The configuration is loaded by the byjg/config library.

Get the configuration

Use the Config::get() method:

Config::get('WEB_SERVER');

Environment Hierarchy

The available environments are defined in the config/ConfigBootstrap.php file.

The project has four environments with the following inheritance hierarchy:

Inheritance Rules:

• test inherits from dev
• staging inherits from dev (with caching enabled)
• prod inherits from staging and dev (with caching enabled)

Child environments override parent configurations. For example:

• config/dev/credentials.env defines base database connection
• config/prod/credentials.env overrides with production database connection
• config/prod/01-infrastructure.php overrides to use FileSystemCache instead of NoCache

You can modify the environment hierarchy in config/ConfigBootstrap.php:

<?php

use ByJG\Cache\Psr16\FileSystemCacheEngine;
use ByJG\Config\ConfigInitializeInterface;
use ByJG\Config\Definition;
use ByJG\Config\Environment;

return new class implements ConfigInitializeInterface {
    public function loadDefinition(?string $env = null): Definition
    {
        // Define environments with inheritance and caching using fluent API
        $dev = Environment::create('dev');
        $test = Environment::create('test')->inheritFrom($dev);
        $staging = Environment::create('staging')->inheritFrom($dev)->withCache(new FileSystemCacheEngine());
        $prod = Environment::create('prod')->inheritFrom($staging, $dev)->withCache(new FileSystemCacheEngine());

        // Create definition with all environments
        return (new Definition())
            ->addEnvironment($dev)
            ->addEnvironment($test)
            ->addEnvironment($staging)
            ->addEnvironment($prod)
            ->withOSEnvironment([
                'TAG_VERSION',
                'TAG_COMMIT',
            ]);
    }
};

The Config is automatically initialized when first accessed, thanks to byjg/config's auto-initialization feature.