Peskovnik
*********

.[perex]
Peskovnik zagotavlja varnostno plast, ki omogoča nadzor nad tem, katere oznake, funkcije PHP, metode itd. se lahko uporabljajo v predlogah. Zahvaljujoč načinu peskovnika lahko pri ustvarjanju predlog varno sodelujete s stranko ali zunanjim programerjem, ne da bi vas skrbelo ogrožanje aplikacije ali neželene operacije.

Kako deluje? Preprosto določimo, kaj želimo dovoliti v predlogi. Na začetku je vse prepovedano, nato pa postopoma dodeljujemo dovoljenja. Naslednja koda dovoli predlogi uporabo oznak `{block}`, `{if}`, `{else}` in `{=}` (slednja je oznaka za [izpis spremenljivke ali izraza |tags#Printing]) ter vseh filtrov:

```php
$policy = new Latte\Sandbox\SecurityPolicy;
$policy->allowTags(['block', 'if', 'else', '=']);
$policy->allowFilters($policy::All);

$latte->setPolicy($policy);
```

Dovolimo lahko tudi dostop do globalnih funkcij, metod ali lastnosti predmetov:

```php
$policy->allowFunctions(['trim', 'strlen']);
$policy->allowMethods(Nette\Security\User::class, ['isLoggedIn', 'isAllowed']);
$policy->allowProperties(Nette\Database\Row::class, $policy::All);
```

Ali ni to neverjetno? Vse lahko nadzorujete na zelo nizki ravni. Če predloga poskuša poklicati nedovoljeno funkcijo ali dostopati do nedovoljene metode ali lastnosti, vrže izjemo `Latte\SecurityViolationException`.

Ustvarjanje politik od začetka, ko je vse prepovedano, morda ni primerno, zato lahko začnete z varnimi temelji:

```php
$policy = Latte\Sandbox\SecurityPolicy::createSafePolicy();
```

To pomeni, da so dovoljene vse standardne oznake, razen `contentType`, `debugbreak`, `dump`, `extends`, `import`, `include`, `layout`, `php`, `sandbox`, `snippet`, `snippetArea`, `templatePrint`, `varPrint`, `widget`.
Prav tako so dovoljeni vsi standardni filtri, razen `datastream`, `noescape` in `nocheck`. Končno je dovoljen tudi dostop do metod in lastnosti objekta `$iterator`.

Pravila veljajo za predlogo, ki jo vstavimo z novim [`{sandbox}` |tags#Including Templates] oznako. Ki je nekaj podobnega kot `{include}`, vendar vklopi način peskovnika in tudi ne posreduje nobenih zunanjih spremenljivk:

```latte
{sandbox 'untrusted.latte'}
```

Tako lahko postavitev in posamezne strani uporabljajo vse oznake in spremenljivke kot prej, omejitve pa bodo veljale le za predlogo `untrusted.latte`.

Nekatere kršitve, kot je uporaba prepovedane oznake ali filtra, se zaznajo v času sestavljanja. Druge, kot je klicanje nedovoljenih metod objekta, pa ob izvajanju.
Predloga lahko vsebuje tudi katere koli druge napake. Če želite preprečiti, da bi se iz predloge v peskovniku vrgla izjema, ki bi motila celotno izrisovanje, lahko določite [svoj lasten obdelovalec izjem |develop#exception handler], ki jo na primer samo zabeleži.

Če želimo način peskovnika vklopiti neposredno za vse predloge, je to preprosto:

```php
$latte->setSandboxMode();
```

Če želite zagotoviti, da uporabnik na stran ne vstavi kode PHP, ki je sintaktično pravilna, vendar prepovedana in povzroči napako pri sestavljanju PHP, priporočamo, da se [predloge preverijo s programskim vmesnikom PHP |develop#Checking Generated Code]. To funkcijo lahko aktivirate z metodo Engine::enablePhpLint(). Ker mora za preverjanje poklicati binarni program PHP, kot parameter podajte njegovo pot:

```php
$latte = new Latte\Engine;
$latte->enablePhpLinter('/path/to/php');
```