Конфигурационный файл config.php в администрировании PHP

Пример 1: полный конфигурационный файл с вложенными массивами и комментариями

// admin/config_full.php
// Конфигурация административной панели
return [
    'database' => [
        'driver' => 'mysql',
        'host' => '127.0.0.1',
        'port' => 3306,
        'database' => 'admin_db',
        'username' => 'admin_user',
        'password' => 'admin_pass',
        'charset' => 'utf8mb4',
    ],
    'session' => [
        'name' => 'ADMIN_SESSION',
        'lifetime' => 86400, // 24 часа
        'cookie_secure' => true,
        'cookie_httponly' => true,
    ],
    'security' => [
        'csrf_secret' => 'kL8s2fD9xQ',
        'max_login_attempts' => 5,
        'lockout_time' => 900, // 15 минут
    ],
    'app' => [
        'name' => 'Моя админка',
        'version' => '1.0.0',
        'upload_max_size' => 10 * 1024 * 1024, // 10 MB
        'allowed_extensions' => ['jpg', 'png', 'pdf'],
    ],
    'paths' => [
        'base_url' => '/admin',
        'upload_dir' => __DIR__ . '/storage/uploads',
        'log_dir' => __DIR__ . '/storage/logs',
    ],
];

Результат: массив со всеми параметрами, доступный после require.

array(5) {
  ["database"]=> array(7) { ... }
  ["session"]=> array(4) { ... }
  ...
}

Пример 2: класс Config с доступом к группам и значениям по умолчанию

// admin/Config.php
class AdminConfig {
    private array $data;

    public function __construct(string $configFile) {
        if (!file_exists($configFile)) {
            throw new \RuntimeException("Config file not found: $configFile");
        }
        $this->data = require $configFile;
    }

    public function getGroup(string $group): array {
        return $this->data[$group] ?? [];
    }

    public function getValue(string $group, string $key, $default = null) {
        return $this->data[$group][$key] ?? $default;
    }

    public function setValue(string $group, string $key, $value): void {
        $this->data[$group][$key] = $value;
    }

    public function save(string $filePath = null): void {
        $path = $filePath ?? __DIR__ . '/config_saved.php';
        $content = '<? return ' . var_export($this->data, true) . ';';
        file_put_contents($path, $content);
    }
}

// Использование
$config = new AdminConfig(__DIR__ . '/config_full.php');
echo $config->getValue('app', 'name'); // Моя админка
$config->setValue('app', 'version', '2.0.0');
$config->save(); // Сохранит изменённую конфигурацию

Результат: новое значение версии в сохранённом файле.

Пример 3: объединение конфигурации из нескольких источников (файл + environment)

// admin/config_merge.php
function loadConfig(string $file): array {
    $base = file_exists($file) ? require $file : [];
    // Переменные окружения с префиксом ADMIN_ перезаписывают значения
    foreach (getenv() as $key => $value) {
        if (strpos($key, 'ADMIN_') === 0) {
            $parts = explode('_', strtolower(substr($key, 6)), 2);
            if (count($parts) === 2) {
                $group = $parts[0];
                $param = $parts[1];
                $base[$group][$param] = $value;
            }
        }
    }
    return $base;
}

$config = loadConfig(__DIR__ . '/config.php');

Если в .env указано ADMIN_DB_HOST=prod_host, то $config['db']['host'] будет prod_host.

Пример 4: кэширование конфигурации в файл с проверкой актуальности

// admin/config_cache.php
function getConfigCached(string $sourceFile, string $cacheFile): array {
    if (file_exists($cacheFile) && filemtime($cacheFile) >= filemtime($sourceFile)) {
        return require $cacheFile;
    }
    $config = require $sourceFile;
    $content = '<? return ' . var_export($config, true) . ';';
    file_put_contents($cacheFile, $content, LOCK_EX);
    return $config;
}

$config = getConfigCached(__DIR__ . '/config.php', __DIR__ . '/cache/config_cache.php');

Результат: при каждом изменении config.php кэш будет обновляться.

Пример 5: валидация конфигурации при загрузке

// admin/validate_config.php
function validateConfig(array $config, array $requiredKeys): array {
    $errors = [];
    foreach ($requiredKeys as $group => $keys) {
        if (!isset($config[$group])) {
            $errors[] = "Отсутствует группа '$group'";
            continue;
        }
        foreach ($keys as $key) {
            if (!array_key_exists($key, $config[$group])) {
                $errors[] = "Отсутствует ключ '$key' в группе '$group'";
            }
        }
    }
    if ($errors) {
        throw new \InvalidArgumentException("Ошибки конфигурации: " . implode('; ', $errors));
    }
    return $config;
}

$config = require __DIR__ . '/config.php';
$required = [
    'database' => ['host', 'user', 'pass', 'name'],
    'session' => ['lifetime'],
];
$validConfig = validateConfig($config, $required);

Результат: исключение с описанием, если не хватает обязательных полей.