Конфигурация PHP приложения от простых констант до env файлов

Как организовать конфигурацию для нескольких окружений (dev, staging, production) с .env?

Создаются отдельные файлы .env.dev, .env.staging, .env.prod. В зависимости от переменной APP_ENV загружается нужный файл. При этом основной .env содержит значения по умолчанию.

// .env (общий)
APP_ENV=development

// .env.dev
db_host=localhost
db_name=dev_db

// .env.prod
db_host=prod.example.com
db_name=prod_db

// Загрузка
$envFile = __DIR__ . '/.env';
$envSpecific = __DIR__ . '/.env.' . ($_ENV['APP_ENV'] ?? 'development');

$dotenv = Dotenv::createImmutable(__DIR__, '.env');
$dotenv->load();

if (file_exists($envSpecific)) {
    $dotenvSpecific = Dotenv::createImmutable(__DIR__, '.env.' . ($_ENV['APP_ENV'] ?? 'development'));
    $dotenvSpecific->load();
}

echo $_ENV['db_host']; // для dev выведет localhost

Результат выполнения (при APP_ENV=development):

localhost

Как создать класс Config с доступом к настройкам через статические методы?

Это удобно для глобального доступа к конфигурации без зависимости от глобальных переменных.

class Config
{
    private static array $items = [];

    public static function load(string $file): void
    {
        if (!file_exists($file)) {
            throw new RuntimeException("Config file $file not found");
        }
        self::$items = require $file;
    }

    public static function get(string $key, $default = null)
    {
        $keys = explode('.', $key);
        $value = self::$items;
        foreach ($keys as $segment) {
            if (!is_array($value) || !array_key_exists($segment, $value)) {
                return $default;
            }
            $value = $value[$segment];
        }
        return $value;
    }
}

// config/app.php
return [
    'database' => [
        'host' => 'localhost',
        'name' => 'myapp',
    ],
    'app' => [
        'debug' => true,
    ],
];

// index.php
Config::load(__DIR__ . '/config/app.php');
echo Config::get('database.host'); // localhost
echo Config::get('app.debug', false); // true
echo Config::get('nonexistent.key', 'default'); // default

Результат:

localhost
true
default

Как загрузить конфигурацию из YAML и объединить с .env?

В современных приложениях часто используют YAML для структуры, а секреты подтягивают из переменных окружения. Пример с использованием библиотеки symfony/yaml и phpdotenv.

// config.yaml
database:
  host: '%env(DB_HOST)%'
  name: '%env(DB_NAME)%'

services:
  - class: App\Service\Mailer
    arguments:
      apiKey: '%env(MAIL_API_KEY)%'

// Загрузка
$dotenv = Dotenv::createImmutable(__DIR__);
$dotenv->load();

$yamlConfig = Yaml::parseFile('config.yaml');

// Рекурсивная замена %env(VAR)% на значение из окружения
function resolveEnvPlaceholders(array $config): array
{
    array_walk_recursive($config, function (&$value) {
        if (preg_match('/^%env\((\w+)\)%$/', $value, $matches)) {
            $envValue = getenv($matches[1]);
            if ($envValue === false) {
                throw new RuntimeException("Environment variable {$matches[1]} not set");
            }
            $value = $envValue;
        }
    });
    return $config;
}

$config = resolveEnvPlaceholders($yamlConfig);
print_r($config);

Результат при наличии DB_HOST и DB_NAME в .env:

Array
(
    [database] => Array
        (
            [host] => localhost
            [name] => myapp
        )

    [services] => Array
        (
            [0] => Array
                (
                    [class] => App\Service\Mailer
                    [arguments] => Array
                        (
                            [apiKey] => your-mail-api-key
                        )

                )

        )

)