nette/di 3.2.4

dependency-injection/cs/configuration.texy

@@ -96,11 +96,25 @@ di:
 	# typy parametrů, které nikdy neautowirovat
 	excluded: ...        # (string[])
 
+	# povolit lazy vytváření služeb?
+	lazy: ...            # (bool) výchozí je false
+
 	# třída, od které dědí DI kontejner
 	parentClass: ...     # (string) výchozí je Nette\DI\Container
 ```
 
 
+Lazy vytváření služeb .{data-version:3.2.0}
+-------------------------------------------
+
+Nastavení `lazy: true` aktivuje lazy (odložené) vytváření služeb. To znamená, že služby nejsou skutečně vytvořeny v okamžiku, kdy si je vyžádáme z DI kontejneru, ale až ve chvíli jejich prvního použití. Což může zrychlit start aplikace a snížit paměťové nároky, protože se vytváří jen ty služby, které jsou v daném requestu skutečně potřeba.
+
+U konkrétní služby lze lazy vytváření [vypnout|services#lazy].
+
+.[note]
+Lazy objekty lze použít pouze pro uživatelské třídy, nikoliv pro interní PHP třídy. Vyžaduje PHP 8.4 nebo novější.
+
+
 Export metadat
 --------------
 

dependency-injection/cs/services.texy

@@ -340,6 +340,24 @@ services:
 ```
 
 
+Lazy služby .{data-version:3.2.0}
+=================================
+
+Lazy loading je technika, která odkládá vytvoření služby až do chvíle, kdy je skutečně potřeba. V globální konfiguraci lze [povolit lazy vytváření|configuration#Lazy vytváření služeb] pro všechny služby najednou. Pro jednotlivé služby pak můžete toto chování přepsat:
+
+```neon
+services:
+	foo:
+		create: Foo
+		lazy: false   # tato služba se vytvoří hned při vyžádání z kontejneru i když je lazy globálně zapnuté
+```
+
+Když je služba definovaná jako lazy, při jejím vyžádání z DI kontejneru dostaneme speciální zástupný objekt. Ten vypadá a chová se stejně jako skutečná služba, ale skutečná inicializace (volání konstruktoru a setupu) proběhne až při prvním volání jakékoliv její metody nebo property.
+
+.[note]
+Lazy loading lze použít pouze pro uživatelské třídy, nikoliv pro interní PHP třídy. Vyžaduje PHP 8.4 nebo novější.
+
+
 Tagy
 ====