new Bootstrap API

application/bg/bootstrap.texy

@@ -20,18 +20,44 @@ use Nette\Bootstrap\Configurator;
 
 class Bootstrap
 {
-	public static function boot(): Configurator
+	private Configurator $configurator;
+	private string $rootDir;
+
+	public function __construct()
+	{
+		$this->rootDir = dirname(__DIR__);
+		// Конфигураторът отговаря за настройката на средата на приложението и услугите.
+		$this->configurator = new Configurator;
+		// Задайте директорията за временни файлове, генерирани от Nette (напр. компилирани шаблони)
+		$this->configurator->setTempDirectory($this->rootDir . '/temp');
+	}
+
+	public function bootWebApplication(): Nette\DI\Container
 	{
-		$rootDir = dirname(__DIR__);
-		$configurator = new Configurator;
-		//$configurator->setDebugMode('[email protected]');
-		$configurator->enableTracy($rootDir . '/log');
-		$configurator->setTempDirectory($rootDir . '/temp');
-		$configurator->createRobotLoader()
+		$this->initializeEnvironment();
+		$this->setupContainer();
+		return $this->configurator->createContainer();
+	}
+
+	private function initializeEnvironment(): void
+	{
+		// Nette е интелигентен и режимът за разработка се включва автоматично,
+		// или можете да го включите за определен IP адрес, като разкоментирате следния ред:
+		// $this->configurator->setDebugMode('[email protected]');
+
+		// Активира Tracy: най-добрият инструмент за отстраняване на грешки "швейцарско ножче".
+		$this->configurator->enableTracy($this->rootDir . '/log');
+
+		// RobotLoader: автоматично зарежда всички класове в дадената директория
+		$this->configurator->createRobotLoader()
 			->addDirectory(__DIR__)
 			->register();
-		$configurator->addConfig($rootDir . '/config/common.neon');
-		return $configurator;
+	}
+
+	private function setupContainer(): void
+	{
+		// Зареждане на конфигурационни файлове
+		$this->configurator->addConfig($this->rootDir . '/config/common.neon');
 	}
 }
 ```
@@ -40,16 +66,15 @@ class Bootstrap
 index.php .[#toc-index-php]
 ===========================
 
-В случая на уеб приложения началният файл е `index.php`, който се намира в публичната директория `www/`. Той позволява на класа `Bootstrap` да инициализира средата и връща `$configurator`, който създава контейнера DI. След това тя извлича услугата `Application`, която стартира уеб приложението:
+Началният файл за уеб приложенията е `index.php`, разположен в публичната директория `www/`. Той използва класа `Bootstrap` за инициализиране на средата и създаване на контейнер DI. След това получава услугата `Application` от контейнера, която стартира уеб приложението:
 
 ```php
-// инициализиране на средата + получаване на обект Configurator
-$configurator = App\Bootstrap::boot();
-// създаване на DI-контейнер
-$container = $configurator->createContainer();
-// DI-контейнерът ще създаде обект Nette\Application\Application
+$bootstrap = new App\Bootstrap;
+// Иницииране на средата + създаване на контейнер DI
+$container = $bootstrap->bootWebApplication();
+// Контейнерът DI създава обект Nette\Application\Application
 $application = $container->getByType(Nette\Application\Application::class);
-//стартиране на приложението Nette
+// Стартирайте приложението Nette и обработете входящата заявка
 $application->run();
 ```
 
@@ -66,19 +91,19 @@ Nette прави разграничение между два основни р
 Ако искате да активирате режима за разработка в други случаи, например за програмисти, които имат достъп от определен IP адрес, можете да използвате `setDebugMode()`:
 
 ```php
-$configurator->setDebugMode('23.75.345.200'); // един или повече IP адреси
+$this->configurator->setDebugMode('23.75.345.200'); // един или повече IP адреси
 ```
 
 Определено препоръчваме да комбинирате IP адреса с "бисквитка". Ще съхраним тайния токен в "бисквитката" `nette-debug', например, `secret1234`, а режимът за разработка ще бъде активиран за програмистите с тази комбинация от IP и "бисквитка".
 
 ```php
-$configurator->setDebugMode('[email protected]');
+$this->configurator->setDebugMode('[email protected]');
 ```
 
 Можете да деактивирате напълно режима за разработчици, дори за localhost:
 
 ```php
-$configurator->setDebugMode(false);
+$this->configurator->setDebugMode(false);
 ```
 
 Обърнете внимание, че стойността `true` активира плътно режима за разработчици, което никога не трябва да се случва на производствен сървър.
@@ -90,7 +115,7 @@ $configurator->setDebugMode(false);
 За да улесним дебъгването, ще включим чудесния инструмент [Tracy |tracy:]. В режим за разработчици той визуализира грешките, а в производствен режим записва грешките в определена директория:
 
 ```php
-$configurator->enableTracy($rootDir . '/log');
+$this->configurator->enableTracy($this->rootDir . '/log');
 ```
 
 
@@ -100,7 +125,7 @@ $configurator->enableTracy($rootDir . '/log');
 Nette използва кеш за DI-контейнер, RobotLoader, шаблони и др. Затова е необходимо да се зададе пътят до директорията, в която се съхранява кешът:
 
 ```php
-$configurator->setTempDirectory($rootDir . '/temp');
+$this->configurator->setTempDirectory($this->rootDir . '/temp');
 ```
 
 В Linux или macOS задайте [разрешения за запис |nette:troubleshooting#Setting-Directory-Permissions] за директориите `log/` и `temp/`.
@@ -112,7 +137,7 @@ RobotLoader .[#toc-robotloader]
 Обикновено искаме да заредим класовете автоматично с помощта на [RobotLoader |robot-loader:], така че трябва да го стартираме и да му позволим да зареди класовете от директорията, в която се намира `Bootstrap.php` (т.е. `__DIR__`) и всички негови поддиректории:
 
 ```php
-$configurator->createRobotLoader()
+$this->configurator->createRobotLoader()
 	->addDirectory(__DIR__)
 	->register();
 ```
@@ -126,7 +151,7 @@ $configurator->createRobotLoader()
 Конфигураторът ви позволява да зададете часовата зона за вашето приложение.
 
 ```php
-$configurator->setTimeZone('Europe/Prague');
+$this->configurator->setTimeZone('Europe/Prague');
 ```
 
 
@@ -143,16 +168,17 @@ $configurator->setTimeZone('Europe/Prague');
 Файловете за конфигурация се зареждат с помощта на `addConfig()`:
 
 ```php
-$configurator->addConfig($rootDir . '/config/common.neon');
+$this->configurator->addConfig($this->rootDir . '/config/common.neon');
 ```
 
 Методът `addConfig()` може да се извика няколко пъти, за да се добавят няколко файла.
 
 ```php
-$configurator->addConfig($rootDir . '/config/common.neon');
-$configurator->addConfig($rootDir . '/config/services.neon');
+$configDir = $this->rootDir . '/config';
+$this->configurator->addConfig($configDir . '/common.neon');
+$this->configurator->addConfig($configDir . '/services.neon');
 if (PHP_SAPI === 'cli') {
-	$configurator->addConfig($rootDir . '/config/cli.php');
+	$this->configurator->addConfig($configDir . '/cli.php');
 }
 ```
 
@@ -169,7 +195,7 @@ if (PHP_SAPI === 'cli') {
 Параметрите, използвани в конфигурационните файлове, могат да бъдат дефинирани [в раздела `parameters` |dependency-injection:configuration#parameters] и да бъдат взети (или презаписани) от метода `addStaticParameters()` (той има псевдоним `addParameters()`). Важно е, че различните стойности на параметрите водят до генериране на допълнителни DI-контейнери, т.е. допълнителни класове.
 
 ```php
-$configurator->addStaticParameters([
+$this->configurator->addStaticParameters([
 	'projectId' => 23,
 ]);
 ```
@@ -183,15 +209,15 @@ $configurator->addStaticParameters([
 Възможно е също така да се добавят динамични параметри към контейнер. Различните им стойности, за разлика от статичните параметри, не генерират нови контейнери DI.
 
 ```php
-$configurator->addDynamicParameters([
+$this->configurator->addDynamicParameters([
 	'remoteIp' => $_SERVER['REMOTE_ADDR'],
 ]);
 ```
 
 Достъпът до променливите на средата е лесен с помощта на динамични параметри. Достъпът до тях се осъществява чрез `%env.variable%` в конфигурационните файлове.
 
 ```php
-$configurator->addDynamicParameters([
+$this->configurator->addDynamicParameters([
 	'env' => getenv(),
 ]);
 ```
@@ -226,7 +252,7 @@ services:
 Създайте нов екземпляр и го вмъкнете в Bootstrap:
 
 ```php
-$configurator->addServices([
+$this->configurator->addServices([
 	'myservice' => new App\Model\MyCustomService('foobar'),
 ]);
 ```
@@ -235,13 +261,21 @@ $configurator->addServices([
 Различни среди .[#toc-different-environments]
 =============================================
 
-Не се колебайте да персонализирате класа `Bootstrap` според нуждите си. Можете да добавите параметри към метода `boot()`, за да разделите уеб проектите, или да добавите други методи, като например `bootForTests()`, който инициализира средата за тестове на единици, `bootForCli()` за скриптове, извикани от командния ред, и т.н.
+Не се колебайте да персонализирате класа `Bootstrap` според нуждите си. Можете да добавите параметри към метода `bootWebApplication()`, за да разграничите отделните уеб проекти. Като алтернатива можете да добавите и други методи, например `bootTestEnvironment()` за инициализиране на средата за unit тестове, `bootConsoleApplication()` за скриптове, извикани от командния ред, и т.н.
 
 ```php
-public static function bootForTests(): Configurator
+public function bootTestEnvironment(): Nette\DI\Container
+{
+	Tester\Environment::setup(); // Инициализация на Nette Tester
+	$this->setupContainer();
+	return $this->configurator->createContainer();
+}
+
+public function bootConsoleApplication(): Nette\DI\Container
 {
-	$configurator = self::boot();
-	Tester\Environment::setup(); // Инициализация Nette Tester
-	return $configurator;
+	$this->configurator->setDebugMode(false);
+	$this->initializeEnvironment();
+	$this->setupContainer();
+	return $this->configurator->createContainer();
 }
 ```