Replace "annotation inject" with "attribute Inject" #1066

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,17 @@
	name: Coding Style

	on: [push, pull_request]

	jobs:
	nette_cc:
	name: Nette Code Checker
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v3
	- uses: shivammathur/setup-php@v2
	with:
	php-version: 8.3
	coverage: none

	- run: composer create-project nette/code-checker temp/code-checker ^3 --no-progress
	- run: php temp/code-checker/code-checker --no-progress

13 changes: 0 additions & 13 deletions .travis.yml

Show comments View file Open in desktop

This file was deleted.

5 changes: 3 additions & 2 deletions application/bg/@home.texy

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -28,8 +28,9 @@ composer require nette/application

		\| версия на пакета \| съвместима версия на PHP
		\|-----------------------\|-----------------------
	\| Nette Application 4.0 \| PHP 8.0 - 8.1
	\| Nette Application 3.1 \| PHP 7.2 - 8.1
	\| Nette Application 4.0 \| PHP 8.1 – 8.3
	\| Nette Application 3.2 \| PHP 8.1 – 8.3
	\| Nette Application 3.1 \| PHP 7.2 – 8.3
		\| Nette Application 3.0 \| PHP 7.1 - 8.0
		\| Nette Application 2.4 \| PHP 5.6 - 8.0

Expand Down

268 changes: 116 additions & 152 deletions application/bg/ajax.texy

Show comments View file Open in desktop

Large diffs are not rendered by default.

107 changes: 71 additions & 36 deletions application/bg/bootstrap.texy

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -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
		{
	$appDir = dirname(__DIR__);
	$configurator = new Configurator;
	//$configurator->setDebugMode('secret@23.75.345.200');
	$configurator->enableTracy($appDir . '/log');
	$configurator->setTempDirectory($appDir . '/temp');
	$configurator->createRobotLoader()
	$this->initializeEnvironment();
	$this->setupContainer();
	return $this->configurator->createContainer();
	}

	private function initializeEnvironment(): void
	{
	// Nette е интелигентен и режимът за разработка се включва автоматично,
	// или можете да го включите за определен IP адрес, като разкоментирате следния ред:
	// $this->configurator->setDebugMode('secret@23.75.345.200');

	// Активира Tracy: най-добрият инструмент за отстраняване на грешки "швейцарско ножче".
	$this->configurator->enableTracy($this->rootDir . '/log');

	// RobotLoader: автоматично зарежда всички класове в дадената директория
	$this->configurator->createRobotLoader()
		->addDirectory(__DIR__)
		->register();
	$configurator->addConfig($appDir . '/config/common.neon');
	return $configurator;
	}

	private function setupContainer(): void
	{
	// Зареждане на конфигурационни файлове
	$this->configurator->addConfig($this->rootDir . '/config/common.neon');
		}
		}
		```
Expand All		@@ -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();
		```

Expand All		@@ -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('secret1234@23.75.345.200');
	$this->configurator->setDebugMode('secret1234@23.75.345.200');
		```

		Можете да деактивирате напълно режима за разработчици, дори за localhost:

		```php
	$configurator->setDebugMode(false);
	$this->configurator->setDebugMode(false);
		```

		Обърнете внимание, че стойността `true` активира плътно режима за разработчици, което никога не трябва да се случва на производствен сървър.
Expand All		@@ -90,7 +115,7 @@ $configurator->setDebugMode(false);
		За да улесним дебъгването, ще включим чудесния инструмент [Tracy \|tracy:]. В режим за разработчици той визуализира грешките, а в производствен режим записва грешките в определена директория:

		```php
	$configurator->enableTracy($appDir . '/log');
	$this->configurator->enableTracy($this->rootDir . '/log');
		```


Expand All		@@ -100,7 +125,7 @@ $configurator->enableTracy($appDir . '/log');
		Nette използва кеш за DI-контейнер, RobotLoader, шаблони и др. Затова е необходимо да се зададе пътят до директорията, в която се съхранява кешът:

		```php
	$configurator->setTempDirectory($appDir . '/temp');
	$this->configurator->setTempDirectory($this->rootDir . '/temp');
		```

		В Linux или macOS задайте [разрешения за запис \|nette:troubleshooting#Setting-Directory-Permissions] за директориите `log/` и `temp/`.
Expand All		@@ -112,7 +137,7 @@ RobotLoader .[#toc-robotloader]
		Обикновено искаме да заредим класовете автоматично с помощта на [RobotLoader \|robot-loader:], така че трябва да го стартираме и да му позволим да зареди класовете от директорията, в която се намира `Bootstrap.php` (т.е. `__DIR__`) и всички негови поддиректории:

		```php
	$configurator->createRobotLoader()
	$this->configurator->createRobotLoader()
		->addDirectory(__DIR__)
		->register();
		```
Expand All		@@ -126,7 +151,7 @@ $configurator->createRobotLoader()
		Конфигураторът ви позволява да зададете часовата зона за вашето приложение.

		```php
	$configurator->setTimeZone('Europe/Prague');
	$this->configurator->setTimeZone('Europe/Prague');
		```


Expand All		@@ -143,16 +168,17 @@ $configurator->setTimeZone('Europe/Prague');
		Файловете за конфигурация се зареждат с помощта на `addConfig()`:

		```php
	$configurator->addConfig($appDir . '/config/common.neon');
	$this->configurator->addConfig($this->rootDir . '/config/common.neon');
		```

		Методът `addConfig()` може да се извика няколко пъти, за да се добавят няколко файла.

		```php
	$configurator->addConfig($appDir . '/config/common.neon');
	$configurator->addConfig($appDir . '/config/local.neon');
	$configDir = $this->rootDir . '/config';
	$this->configurator->addConfig($configDir . '/common.neon');
	$this->configurator->addConfig($configDir . '/services.neon');
		if (PHP_SAPI === 'cli') {
	$configurator->addConfig($appDir . '/config/cli.php');
	$this->configurator->addConfig($configDir . '/cli.php');
		}
		```

Expand All		@@ -169,7 +195,7 @@ if (PHP_SAPI === 'cli') {
		Параметрите, използвани в конфигурационните файлове, могат да бъдат дефинирани [в раздела `parameters` \|dependency-injection:configuration#parameters] и да бъдат взети (или презаписани) от метода `addStaticParameters()` (той има псевдоним `addParameters()`). Важно е, че различните стойности на параметрите водят до генериране на допълнителни DI-контейнери, т.е. допълнителни класове.

		```php
	$configurator->addStaticParameters([
	$this->configurator->addStaticParameters([
		'projectId' => 23,
		]);
		```
Expand All		@@ -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(),
		]);
		```
Expand All		@@ -206,6 +232,7 @@ $configurator->addDynamicParameters([
		- `%wwwDir%` е абсолютният път до директорията, съдържаща входния файл `index.php`
		- `%tempDir%` е абсолютният път до директорията за временни файлове
		- `%vendorDir%` е абсолютният път до директорията, в която Composer инсталира библиотеки
	- `%rootDir%` е абсолютният път до главната директория на проекта
		- `%debugMode%` показва дали приложението е в режим на отстраняване на грешки
		- `%consoleMode%` показва дали заявката е постъпила от командния ред

Expand All		@@ -225,7 +252,7 @@ services:
		Създайте нов екземпляр и го вмъкнете в Bootstrap:

		```php
	$configurator->addServices([
	$this->configurator->addServices([
		'myservice' => new App\Model\MyCustomService('foobar'),
		]);
		```
Expand All		@@ -234,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();
		}
		```

26 changes: 24 additions & 2 deletions application/bg/components.texy

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -230,6 +230,28 @@ $this->redirect(/* ... */); // пренасочване
		```


	Пренасочване след сигнал .[#toc-redirection-after-a-signal]
	===========================================================

	След обработката на сигнал от компонент често следва пренасочване. Тази ситуация е подобна на формулярите - след изпращане на формуляр също пренасочваме, за да предотвратим повторното изпращане на данни, когато страницата се опреснява в браузъра.

	```php
	$this->redirect('this') // redirects to the current presenter and action
	```

	Тъй като компонентът е елемент за многократна употреба и обикновено не трябва да има пряка зависимост от конкретни презентатори, методите `redirect()` и `link()` автоматично интерпретират параметъра като сигнал за компонент:

	```php
	$this->redirect('click') // redirects to the 'click' signal of the same component
	```

	Ако трябва да пренасочите към друг презентатор или действие, можете да го направите чрез презентатора:

	```php
	$this->getPresenter()->redirect('Product:show'); // redirects to a different presenter/action
	```


		Постоянни параметри .[#toc-persistent-parameters]
		=================================================

Expand Down Expand Up		@@ -347,7 +369,7 @@ services:
		Накрая ще използваме тази фабрика в нашия презентатор:

		```php
	class PollPresenter extends Nette\UI\Application\Presenter
	class PollPresenter extends Nette\Application\UI\Presenter
		{
		public function __construct(
		private PollControlFactory $pollControlFactory,
Expand Down Expand Up		@@ -380,7 +402,7 @@ interface PollControlFactory
		Компонентите в Nette Application са части за многократна употреба на уеб приложение, които вграждаме в страници, което е предмет на тази глава. Какви са възможностите на такъв компонент?

		1) може да се показва в шаблон
	2) той знае каква част от себе си да покаже по време на [заявката AJAX \|ajax#invalidation] (фрагменти)
	2) знае [коя част от себе си \|ajax#snippets] да визуализира по време на заявка AJAX (фрагменти).
		3) има възможност да съхранява състоянието си в URL (постоянни параметри).
		4) има възможност да реагира на действията (сигналите) на потребителя.
		5) създава йерархична структура (където коренът е главният).
Expand Down

Original file line number	Diff line number	Diff line change
Expand Up		@@ -28,8 +28,9 @@ composer require nette/application

		\| версия на пакета \| съвместима версия на PHP
		\|-----------------------\|-----------------------
	\| Nette Application 4.0 \| PHP 8.0 - 8.1
	\| Nette Application 3.1 \| PHP 7.2 - 8.1
	\| Nette Application 4.0 \| PHP 8.1 – 8.3
	\| Nette Application 3.2 \| PHP 8.1 – 8.3
	\| Nette Application 3.1 \| PHP 7.2 – 8.3
		\| Nette Application 3.0 \| PHP 7.1 - 8.0
		\| Nette Application 2.4 \| PHP 5.6 - 8.0

Expand Down

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Replace "annotation inject" with "attribute Inject" #1066

Are you sure you want to change the base?

Uh oh!

Replace "annotation inject" with "attribute Inject" #1066

Filter by extension

Uh oh!

Diff view

Diff view

Uh oh!

There are no files selected for viewing

Uh oh!

Uh oh!

Uh oh!