Задание значений по умолчанию для конфигурации в PHP

Цепочка операторов ?? для вложенных значений

Когда нужно извлечь значение из многомерного массива, используя несколько уровней проверки.

$config = [
    'database' => [
        'mysql' => [
            'host' => '127.0.0.1'
        ]
    ]
];

$host = $config['database']['mysql']['host'] ?? $config['database']['mysql']['port'] ?? 'localhost';
echo $host; // 127.0.0.1

$port = $config['database']['mysql']['port'] ?? $config['database']['postgres']['port'] ?? 3306;
echo $port; // 3306
  

127.0.0.1
3306
  

Цепочка работает слева направо, возвращая первое не-null значение.

Комбинирование getenv с ?? для переменных окружения с приоритетом

Часто требуется сначала проверить переменную окружения, затем значение из .env файла, и только потом жёстко заданное умолчание.

// Пример с воображаемой функцией dotenv_load()
$envs = dotenv_load(__DIR__ . '/.env');

$app_key = getenv('APP_KEY') ?? $envs['APP_KEY'] ?? 'changeme';
echo $app_key; // выведет значение из окружения, либо из .env, либо 'changeme'
  

Значения по умолчанию для параметров функций с помощью синтаксиса PHP 8

В PHP 8 можно задавать значения по умолчанию для именованных аргументов, а также использовать атрибуты для конфигурации.

function connect(string $host = 'localhost', int $port = 3306): void {
    echo "Соединение с $host:$port";
}

connect(); // localhost:3306
connect('db.example.com', 5432); // db.example.com:5432
  

Соединение с localhost:3306
Соединение с db.example.com:5432
  

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

Применение match с ??? для выбора конфигурации на основе условия

Выражение match в PHP 8 может возвращать значение, а оператор ?? позволяет задать запасной вариант, если ни один из вариантов не подошёл.

$env = getenv('APP_ENV');
$debug = match ($env) {
    'development' => true,
    'staging' => true,
    'production' => false,
    default => false
} ?? false; // если match вернёт null (например, при неопределённом $env)

echo $debug ? '1' : '0';
  

В этом примере match вернёт false для production и default, true для development и staging. Оператор ?? сработает только если $env не определён (так как match не вызывается для неопределённой переменной) - здесь он избыточен, но демонстрирует комбинацию.

Создание конфигурационного объекта с умолчаниями через ??=

Объект конфигурации может лениво заполнять свойства только при первом обращении.

class AppConfig {
    private array $data = [];

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

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

$config = new AppConfig();
$config->setDefault('timeout', 30);
$config->setDefault('timeout', 60); // не изменится, так как уже 30
echo $config->get('timeout'); // 30
  

30
  

Такой подход подходит для конфигураций, загружаемых из разных источников, где важен порядок задания умолчаний.

Обработка $_SERVER с запасными значениями для окружения веб-сервера

В файле index.php часто считывают данные из $_SERVER. Например, протокол, домен, путь к корню.

$protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'] ?? 'localhost';
$basePath = $_SERVER['BASE_PATH'] ?? '/';

$siteUrl = "$protocol://$host$basePath";
echo $siteUrl;
  

http://localhost/
  

В этом примере используются разные стратегии: для протокола - проверка через empty(), для хоста - ??, для базового пути - ??.