Skip to content

Commit b0aa76b

Browse files
committed
application/bootstrap -> bootstrapping
1 parent d136d1a commit b0aa76b

File tree

221 files changed

+436
-419
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

221 files changed

+436
-419
lines changed

application/bg/@left-menu.texy

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Приложение в Nette
22
******************
33
- [Как работят приложенията? |how-it-works]
4-
- [Bootstrap |Bootstrap]
4+
- [Bootstrapping]
55
- [Presenters |presenters]
66
- [Шаблони |templates]
77
- [Директорийна структура |directory-structure]

application/bg/bootstrap.texy renamed to application/bg/bootstrapping.texy

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
1-
Bootstrap
1+
Зареждане
22
*********
33

44
<div class=perex>
55

6-
Bootstrap е зареждащ код, който инициализира средата, създава dependency injection (DI) контейнер и стартира приложението. Ще си поговорим за:
6+
Зареждането е процесът на инициализиране на средата на приложението, създаване на контейнер за инжектиране на зависимости (DI) и стартиране на приложението. Ще обсъдим:
77

8-
- как се конфигурира с помощта на NEON файлове
9-
- как да различим продукционен режим и режим за разработка
10-
- как да създадем DI контейнер
8+
- как класът Bootstrap инициализира средата
9+
- как приложенията се конфигурират чрез NEON файлове
10+
- как да разграничаваме между производствен и разработчически режим
11+
- как да създаваме и конфигурираме DI контейнера
1112

1213
</div>
1314

application/bg/directory-structure.texy

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@
9090
==========================
9191

9292
Тази директория е единствената достъпна от уеб (т.нар. document-root). Често можете да срещнете и името `public/` вместо `www/` - това е само въпрос на конвенция и няма влияние върху функционалността на приложението. Директорията съдържа:
93-
- [Входна точка |bootstrap#index.php] на приложението `index.php`
93+
- [Входна точка |bootstrapping#index.php] на приложението `index.php`
9494
- Файл `.htaccess` с правила за mod_rewrite (при Apache)
9595
- Статични файлове (CSS, JavaScript, изображения)
9696
- Качени файлове
@@ -115,7 +115,7 @@
115115
└── <b>Bootstrap.php</b> ← зареждащ клас на приложението
116116
\--
117117

118-
`Bootstrap.php` е [стартовият клас на приложението|bootstrap], който инициализира средата, зарежда конфигурацията и създава DI контейнер.
118+
`Bootstrap.php` е [стартовият клас на приложението|bootstrapping], който инициализира средата, зарежда конфигурацията и създава DI контейнер.
119119

120120
Нека сега разгледаме отделните поддиректории по-подробно.
121121

application/bg/how-it-works.texy

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,11 @@ HTTP заявка
7575

7676
Каква фабрика? Не произвеждаме трактори, а уеб страници! Изчакайте, веднага ще се изясни.
7777

78-
С думите „инициализация на средата“ имаме предвид например това, че се активира [Tracy|tracy:], което е страхотен инструмент за логване или визуализация на грешки. На продукционен сървър той логва грешки, на сървър за разработка ги показва директно. Следователно към инициализацията принадлежи и решението дали уебсайтът работи в продукционна или развойна среда. За това Nette използва [умна автодетекция |bootstrap#Режим за разработка срещу продукционен режим]: ако стартирате уебсайта на localhost, той работи в развойна среда. Не е необходимо нищо да конфигурирате и приложението е веднага готово както за разработка, така и за реално внедряване. Тези стъпки се извършват и са подробно описани в главата за [клас Bootstrap|bootstrap].
78+
С думите „инициализация на средата“ имаме предвид например това, че се активира [Tracy|tracy:], което е страхотен инструмент за логване или визуализация на грешки. На продукционен сървър той логва грешки, на сървър за разработка ги показва директно. Следователно към инициализацията принадлежи и решението дали уебсайтът работи в продукционна или развойна среда. За това Nette използва [умна автодетекция |bootstrapping#Режим за разработка срещу продукционен режим]: ако стартирате уебсайта на localhost, той работи в развойна среда. Не е необходимо нищо да конфигурирате и приложението е веднага готово както за разработка, така и за реално внедряване. Тези стъпки се извършват и са подробно описани в главата за [клас Bootstrap|bootstrapping].
7979

8080
Третата точка (да, прескочихме втората, но ще се върнем към нея) е стартирането на приложението. Обработката на HTTP заявки в Nette се извършва от класа `Nette\Application\Application` (наричан по-нататък `Application`), така че когато казваме стартиране на приложението, имаме предвид конкретно извикване на метода със знаковото име `run()` върху обекта на този клас.
8181

82-
Nette е ментор, който ви води към писането на чисти приложения според доказани методики. И една от тези абсолютно най-доказани се нарича **dependency injection**, съкратено DI. В този момент не искаме да ви натоварваме с обяснение на DI, за това има [отделна глава|dependency-injection:introduction], същественото последствие е, че ключовите обекти обикновено ще ни ги създава фабрика за обекти, която се нарича **DI контейнер** (съкратено DIC). Да, това е фабриката, за която стана дума преди малко. И тя ще ни произведе и обекта `Application`, затова първо се нуждаем от контейнера. Получаваме го с помощта на класа `Configurator` и го караме да произведе обекта `Application`, извикваме върху него метода `run()` и така се стартира Nette приложението. Точно това се случва във файла [index.php |bootstrap#index.php].
82+
Nette е ментор, който ви води към писането на чисти приложения според доказани методики. И една от тези абсолютно най-доказани се нарича **dependency injection**, съкратено DI. В този момент не искаме да ви натоварваме с обяснение на DI, за това има [отделна глава|dependency-injection:introduction], същественото последствие е, че ключовите обекти обикновено ще ни ги създава фабрика за обекти, която се нарича **DI контейнер** (съкратено DIC). Да, това е фабриката, за която стана дума преди малко. И тя ще ни произведе и обекта `Application`, затова първо се нуждаем от контейнера. Получаваме го с помощта на класа `Configurator` и го караме да произведе обекта `Application`, извикваме върху него метода `run()` и така се стартира Nette приложението. Точно това се случва във файла [index.php |bootstrapping#index.php].
8383

8484

8585
Nette Application
@@ -179,7 +179,7 @@ DI контейнерът, или фабриката за обекти, е съ
179179

180180
Обектите, които DI контейнерът създава, по някаква причина се наричат сървиси.
181181

182-
Това, което е наистина специално в този клас, е, че не го програмирате вие, а фреймуъркът. Той наистина генерира PHP код и го съхранява на диска. Вие само давате инструкции какви обекти трябва да може да произвежда контейнерът и как точно. И тези инструкции са записани в [конфигурационни файлове |bootstrap#Конфигурация на DI контейнера], за които се използва форматът [NEON|neon:format] и следователно имат и разширение `.neon`.
182+
Това, което е наистина специално в този клас, е, че не го програмирате вие, а фреймуъркът. Той наистина генерира PHP код и го съхранява на диска. Вие само давате инструкции какви обекти трябва да може да произвежда контейнерът и как точно. И тези инструкции са записани в [конфигурационни файлове |bootstrapping#Конфигурация на DI контейнера], за които се използва форматът [NEON|neon:format] и следователно имат и разширение `.neon`.
183183

184184
Конфигурационните файлове служат чисто за инструктиране на DI контейнера. Така че, когато например посоча в секцията [session |http:configuration#Сесия] опцията `expiration: 14 days`, DI контейнерът при създаването на обекта `Nette\Http\Session`, представляващ сесията, ще извика неговия метод `setExpiration('14 days')` и така конфигурацията ще стане реалност.
185185

application/cs/@left-menu.texy

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Aplikace v Nette
22
****************
33
- [Jak fungují aplikace? |how-it-works]
4-
- [Bootstrap]
4+
- [Bootstrapping]
55
- [Presentery |presenters]
66
- [Šablony |templates]
77
- [Adresářová struktura |directory-structure]

application/cs/bootstrap.texy renamed to application/cs/bootstrapping.texy

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
1-
Bootstrap
2-
*********
1+
Bootstrapping
2+
*************
33

44
<div class=perex>
55

6-
Bootstrap je zaváděcí kód, který inicializuje prostředí, vytvoří dependency injection (DI) kontejner a spustí aplikaci. Řekneme si:
6+
Bootstrapping je proces inicializace prostředí aplikace, vytvoření kontejneru pro dependency injection (DI) a spuštění aplikace. Budeme probírat:
77

8-
- jak se konfiguruje pomocí NEON souborů
9-
- jak rozlišit produkční a vývojářský režim
10-
- jak vytvořit DI kontejner
8+
- jak třída Bootstrap inicializuje prostředí
9+
- jak jsou aplikace konfigurovány pomocí NEON souborů
10+
- jak rozlišovat mezi produkčním a vývojářským režimem
11+
- jak vytvořit a nakonfigurovat DI kontejner
1112

1213
</div>
1314

application/cs/directory-structure.texy

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ Veřejný adresář `www/`
9090
======================
9191

9292
Tento adresář je jediný přístupný z webu (tzv. document-root). Často se můžete setkat i s názvem `public/` místo `www/` - je to jen otázka konvence a na funkčnost rostlináře to nemá vliv. Adresář obsahuje:
93-
- [Vstupní bod |bootstrap#index.php] aplikace `index.php`
93+
- [Vstupní bod |bootstrapping#index.php] aplikace `index.php`
9494
- Soubor `.htaccess` s pravidly pro mod_rewrite (u Apache)
9595
- Statické soubory (CSS, JavaScript, obrázky)
9696
- Uploadované soubory
@@ -115,7 +115,7 @@ Toto je hlavní adresář s aplikačním kódem. Základní struktura:
115115
└── <b>Bootstrap.php</b> ← zaváděcí třída aplikace
116116
\--
117117

118-
`Bootstrap.php` je [startovací třída aplikace|bootstrap], která inicializuje prostředí, načítá konfiguraci a vytváří DI kontejner.
118+
`Bootstrap.php` je [startovací třída aplikace|bootstrapping], která inicializuje prostředí, načítá konfiguraci a vytváří DI kontejner.
119119

120120
Pojďme se nyní podívat na jednotlivé podadresáře podrobněji.
121121

application/cs/how-it-works.texy

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,11 @@ Jeho úkolem je:
7575

7676
Jakou že továrnu? Nevyrábíme přece traktory, ale webové stránky! Vydržte, hned se to vysvětlí.
7777

78-
Slovy „inicializace prostředí“ myslíme například to, že se aktivuje [Tracy|tracy:], což je úžasný nástroj pro logování nebo vizualizaci chyb. Na produkčním serveru chyby loguje, na vývojovém rovnou zobrazuje. Tudíž k inicializaci patří i rozhodnutí, zda web běží v produkčním nebo vývojářském režimu. K tomu Nette používá [chytrou autodetekci |bootstrap#Vývojářský vs produkční režim]: pokud web spouštíte na localhost, běží v režimu vývojářském. Nemusíte tak nic konfigurovat a aplikace je rovnou připravena jak pro vývoj, tak ostré nasazení. Tyhle kroky se provádějí a jsou podrobně rozepsané v kapitole o [třídě Bootstrap|bootstrap].
78+
Slovy „inicializace prostředí“ myslíme například to, že se aktivuje [Tracy|tracy:], což je úžasný nástroj pro logování nebo vizualizaci chyb. Na produkčním serveru chyby loguje, na vývojovém rovnou zobrazuje. Tudíž k inicializaci patří i rozhodnutí, zda web běží v produkčním nebo vývojářském režimu. K tomu Nette používá [chytrou autodetekci |bootstrapping#Vývojářský vs produkční režim]: pokud web spouštíte na localhost, běží v režimu vývojářském. Nemusíte tak nic konfigurovat a aplikace je rovnou připravena jak pro vývoj, tak ostré nasazení. Tyhle kroky se provádějí a jsou podrobně rozepsané v kapitole o [třídě Bootstrap|bootstrapping].
7979

8080
Třetím bodem (ano, druhý jsme přeskočili, ale vrátíme se k němu) je spuštění aplikace. Vyřizování HTTP požadavků má v Nette na starosti třída `Nette\Application\Application` (dále `Application`), takže když říkáme spustit aplikaci, myslíme tím konkrétně zavolání metody s příznačným názvem `run()` na objektu této třídy.
8181

82-
Nette je mentor, který vás vede k psaní čistých aplikací podle osvědčených metodik. A jedna z těch naprosto nejosvědčenějších se nazývá **dependency injection**, zkráceně DI. V tuto chvíli vás nechceme zatěžovat vysvětlováním DI, od toho je tu [samostatná kapitola|dependency-injection:introduction], podstatný je důsledek, že klíčové objekty nám bude obvykle vytvářet továrna na objekty, které se říká **DI kontejner** (zkráceně DIC). Ano, to je ta továrna, o které byla před chvíli řeč. A vyrobí nám i objekt `Application`, proto potřebujeme nejprve kontejner. Získáme jej pomocí třídy `Configurator` a necháme jej vyrobit objekt `Application`, zavoláme na něm metodu `run()` a tím se spustí Nette aplikace. Přesně tohle se děje v souboru [index.php |bootstrap#index.php].
82+
Nette je mentor, který vás vede k psaní čistých aplikací podle osvědčených metodik. A jedna z těch naprosto nejosvědčenějších se nazývá **dependency injection**, zkráceně DI. V tuto chvíli vás nechceme zatěžovat vysvětlováním DI, od toho je tu [samostatná kapitola|dependency-injection:introduction], podstatný je důsledek, že klíčové objekty nám bude obvykle vytvářet továrna na objekty, které se říká **DI kontejner** (zkráceně DIC). Ano, to je ta továrna, o které byla před chvíli řeč. A vyrobí nám i objekt `Application`, proto potřebujeme nejprve kontejner. Získáme jej pomocí třídy `Configurator` a necháme jej vyrobit objekt `Application`, zavoláme na něm metodu `run()` a tím se spustí Nette aplikace. Přesně tohle se děje v souboru [index.php |bootstrapping#index.php].
8383

8484

8585
Nette Application
@@ -179,7 +179,7 @@ Nemějte obavy, není to žádný magický black box, jak by se třeba mohlo z p
179179

180180
Objektům, které DI kontejner vytváří, se z nějakého důvodu říká služby.
181181

182-
Co je na této třídě opravdu speciálního, tak že ji neprogramujete vy, ale framework. On skutečně vygeneruje PHP kód a uloží ho na disk. Vy jen dáváte instrukce, jaké objekty má umět kontejner vyrábět a jak přesně. A tyhle instrukce jsou zapsané v [konfiguračních souborech |bootstrap#Konfigurace DI kontejneru], pro které se používá formát [NEON|neon:format] a tedy mají i příponu `.neon`.
182+
Co je na této třídě opravdu speciálního, tak že ji neprogramujete vy, ale framework. On skutečně vygeneruje PHP kód a uloží ho na disk. Vy jen dáváte instrukce, jaké objekty má umět kontejner vyrábět a jak přesně. A tyhle instrukce jsou zapsané v [konfiguračních souborech |bootstrapping#Konfigurace DI kontejneru], pro které se používá formát [NEON|neon:format] a tedy mají i příponu `.neon`.
183183

184184
Konfigurační soubory slouží čistě k instruování DI kontejneru. Takže když například uvedu v sekci [session |http:configuration#Session] volbu `expiration: 14 days`, tak DI kontejner při vytváření objektu `Nette\Http\Session` reprezentujícího session zavolá jeho metodu `setExpiration('14 days')` a tím se konfigurace stane realitou.
185185

application/de/@left-menu.texy

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Anwendungen in Nette
22
********************
33
- [Wie Anwendungen funktionieren |how-it-works]
4-
- [Bootstrap |Bootstrap]
4+
- [Bootstrapping]
55
- [Presenter |presenters]
66
- [Templates |templates]
77
- [Verzeichnisstruktur |directory-structure]

application/de/bootstrap.texy renamed to application/de/bootstrapping.texy

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
1-
Bootstrap
2-
*********
1+
Bootstrapping
2+
*************
33

44
<div class=perex>
55

6-
Bootstrap ist der Startcode, der die Umgebung initialisiert, den Dependency Injection (DI) Container erstellt und die Anwendung startet. Wir werden erklären:
6+
Bootstrapping ist der Prozess der Initialisierung der Anwendungsumgebung, der Erstellung eines Dependency Injection (DI) Containers und des Startens der Anwendung. Wir werden besprechen:
77

8-
- wie sie mithilfe von NEON-Dateien konfiguriert wird
9-
- wie man zwischen Produktions- und Entwicklungsmodus unterscheidet
10-
- wie man den DI-Container erstellt
8+
- wie die Bootstrap-Klasse die Umgebung initialisiert
9+
- wie Anwendungen mit NEON-Dateien konfiguriert werden
10+
- wie zwischen Produktions- und Entwicklungsmodus unterschieden wird
11+
- wie der DI-Container erstellt und konfiguriert wird
1112

1213
</div>
1314

0 commit comments

Comments
 (0)