Инициализация PHP-проекта: файл init.php и его применение

Как настроить init.php для нескольких окружений (dev/prod)?

Использование файла .env с разными значениями для каждой среды. Пример:

<?
// init.php с поддержкой окружений
$env = getenv('APP_ENV') ?: 'production';
$config = __DIR__ . '/config/' . $env . '.php';
if (!file_exists($config)) {
    die("Configuration not found for environment: $env");
}
require_once $config;

// Автозагрузка через Composer
require_once __DIR__ . '/vendor/autoload.php';

// Настройка отображения ошибок в зависимости от среды
if ($env === 'development') {
    error_reporting(E_ALL);
    ini_set('display_errors', '1');
} else {
    error_reporting(0);
    ini_set('display_errors', '0');
}

// Пример: загрузка переменных из .env
$dotenv = Dotenv\\Dotenv::createImmutable(__DIR__);
$dotenv->load();

Результат выполнения:

При APP_ENV=development включены все ошибки; при production ошибки скрыты, но логируются.

Как подключить контейнер зависимостей (PHP-DI) через init.php?

Контейнер упрощает управление сервисами. Пример:

<?
// init.php с PHP-DI
require_once __DIR__ . '/vendor/autoload.php';

use DI\\ContainerBuilder;

$builder = new ContainerBuilder();
$builder->addDefinitions(__DIR__ . '/config/di.php');
$container = $builder->build();

// Сохранение контейнера в глобальную переменную (не рекомендуется, но часто используется)
$GLOBALS['container'] = $container;

// Сессия и другие настройки
session_start();
error_reporting(E_ALL);

Пояснение:

Файл config/di.php содержит определения классов, например:

<?
return [
    PDO::class => function () {
        return new PDO('mysql:host=localhost;dbname=test', 'root', '');
    },
];

Такой подход позволяет легко заменять реализации для тестирования.

Как написать init.php для CLI-скрипта (cron, artisan)?

CLI-скрипты не требуют сессии, но могут принимать аргументы. Пример:

<?
// init.php для командной строки
if (PHP_SAPI !== 'cli') {
    die('This script is intended for CLI only.');
}

require_once __DIR__ . '/vendor/autoload.php';

// Парсинг аргументов командной строки
$options = getopt('', ['env::']);
$env = $options['env'] ?? 'production';

// Загрузка конфигурации
$configFile = __DIR__ . '/config/' . $env . '.php';
if (file_exists($configFile)) {
    require_once $configFile;
}

// Настройка логгера для CLI
$log = new Monolog\\Logger('cli');
$log->pushHandler(new Monolog\\Handler\\StreamHandler('php://stderr', Monolog\\Logger::INFO));

// Отсутствие сессии – не вызывается session_start()

Результат использования:

При запуске php cli.php --env=development скрипт загружает конфигурацию для разработки.

Как настроить init.php для тестирования с подменой внешних сервисов?

В тестовой среде удобно заменять БД или API на заглушки. Пример:

<?
// init.php для тестов (вызывается из PHPUnit bootstrap)
require_once __DIR__ . '/vendor/autoload.php';

// Определение тестовой конфигурации
define('TEST_MODE', true);

// Подмена соединения с БД на SQLite в памяти
$container = new \\DI\\Container();
$container->set(PDO::class, function () {
    return new PDO('sqlite::memory:');
});

// Сохранение контейнера в глобальное хранилище
$GLOBALS['di'] = $container;

error_reporting(E_ALL);
ini_set('display_errors', '1');

Пояснение:

В тестовом bootstrap используется отдельный init.php, который не запускает сессию и не подключает реальную БД. Это ускоряет тесты и изолирует окружение.

Как реализовать отложенную (lazy) инициализацию в init.php?

Для экономии ресурсов некоторые компоненты подключаются только при первом обращении. Пример с использованием фабрики:

<?
// init.php с lazy-сервисами
require_once __DIR__ . '/vendor/autoload.php';

class Registry {
    private static $instances = [];

    public static function get($key, callable $factory) {
        if (!isset(self::$instances[$key])) {
            self::$instances[$key] = $factory();
        }
        return self::$instances[$key];
    }
}

// Регистрация сервисов (не создаются сразу)
$GLOBALS['reg'] = new Registry();

// Пример использования позже:
// $pdo = Registry::get('pdo', function() { return new PDO(...); });

Преимущества:

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