Seje

Pri uporabi sej vsak uporabnik prejme edinstven identifikator, imenovan ID seje, ki se posreduje v piškotku. Ta služi kot ključ do podatkov seje. Za razliko od piškotkov, ki so shranjeni na strani brskalnika, so podatki o seji shranjeni na strani strežnika.

Sejo konfiguriramo v konfiguraciji, pri čemer je pomembna izbira časa izteka veljavnosti.

Sejo upravlja objekt Nette\Http\Session, ki ga dobimo s posredovanjem z uporabo vbrizgavanja odvisnosti. V predstavitvah preprosto pokličemo $session = $this->getSession().

→ Namestitev in zahteve

Začetek seje

Privzeto bo Nette samodejno zagnal sejo v trenutku, ko bomo začeli brati iz nje ali vanjo pisati podatke. Če želite sejo zagnati ročno, uporabite $session->start().

PHP ob začetku seje pošlje glave HTTP, ki vplivajo na predpomnjenje, glejte session_cache_limiter, in po možnosti piškotek z ID seje. Zato je treba sejo vedno začeti, preden brskalniku pošljemo kakršen koli izpis, sicer se vrže izjema. Če torej veste, da bo seja uporabljena med prikazovanjem strani, jo pred tem ročno zaženite, na primer v predstavitvenem programu.

V načinu za razvijalce Tracy zažene sejo, ker jo uporablja za prikaz preusmeritev in vrstic z zahtevami AJAX v vrstici Tracy.

Razdelek

V čistem jeziku PHP je shramba podatkov seje izvedena kot polje, ki je dostopno prek globalne spremenljivke $_SESSION. Težava je v tem, da so aplikacije običajno sestavljene iz več neodvisnih delov, in če imajo vsi na voljo le eno isto polje, bo prej ali slej prišlo do kolizije imen.

Nette Framework rešuje težavo tako, da celoten prostor razdeli na dele (predmete Nette\Http\SessionSection). Vsaka enota nato uporablja svoj odsek z edinstvenim imenom in do trkov ne more priti.

Odsek dobimo od upravitelja sej:

$section = $session->getSection('unique name');

V predstavitvenem programu je dovolj, da pokličemo getSession() s parametrom:

// $this je Predavatelj
$section = $this->getSession('unique name');

Obstoj odseka lahko preverimo z metodo $session->hasSection('unique name').

S samim odsekom je zelo enostavno delati z metodami set(), get() in remove():

// pisanje spremenljivk
$section->set('userName', 'franta');

// branje spremenljivke, vrne nič, če ne obstaja
echo $section->get('userName');

// odstranjevanje spremenljivke
$section->remove('userName');

Za pridobitev vseh spremenljivk iz razdelka je mogoče uporabiti cikel foreach:

foreach ($section as $key => $val) {
	echo "$key = $val";
}

Kako nastaviti potek veljavnosti

Iztek veljavnosti lahko nastavite za posamezne odseke ali celo posamezne spremenljivke. Uporabnikova prijava lahko poteče čez 20 minut, vendar si lahko še vedno zapomnimo vsebino nakupovalne košarice.

// razdelek poteče po 20 minutah.
$section->setExpiration('20 minutes');

Tretji parameter metode set() se uporablja za nastavitev izteka veljavnosti posameznih spremenljivk:

// spremenljivka 'flash' poteče po 30 sekundah
$section->set('flash', $message, '30 seconds');

Ne pozabite, da mora biti čas poteka celotne seje (glejte konfiguracijo seje) enak ali višji od časa, nastavljenega za posamezne odseke ali spremenljivke.

Preklic predhodno nastavljenega izteka je mogoče doseči z metodo removeExpiration(). Takojšen izbris celotnega odseka bo zagotovljen z metodo remove().

Dogodki $onStart, $onBeforeWrite

Objekt Nette\Http\Session ima dogodka $onStart in $onBeforeWrite, zato lahko dodate povratne klice, ki se kličejo po začetku seje ali preden se seja zapiše na disk in nato zaključi.

$session->onBeforeWrite[] = function () {
	// zapisovanje podatkov v sejo
	$this->section->set('basket', $this->basket);
};

Upravljanje seje

Pregled metod razreda Nette\Http\Session za upravljanje sej:

Konfiguracija

Seanso konfiguriramo v konfiguraciji. Če pišete aplikacijo, ki ne uporablja vsebnika DI, jo konfigurirajte s temi metodami. Poklicati jih je treba pred začetkom seje.

Najprej varnost

Strežnik domneva, da komunicira z istim uporabnikom, dokler zahteve vsebujejo isti ID seje. Naloga varnostnih mehanizmov je zagotoviti, da to vedenje res deluje in da ni možnosti zamenjave ali kraje identifikatorja.

Zato ogrodje Nette Framework ustrezno konfigurira direktive PHP za prenos identifikatorja seje samo v piškotkih, preprečevanje dostopa iz JavaScripta in ignoriranje identifikatorjev v naslovu URL. Poleg tega v kritičnih trenutkih, kot je prijava uporabnika, ustvari nov identifikator seje.

Funkcija ini_set se uporablja za konfiguracijo PHP, vendar je njena uporaba pri nekaterih storitvah spletnega gostovanja žal prepovedana. Če je to vaš primer, poskusite prositi ponudnika gostovanja, da vam to funkcijo dovoli ali vsaj ustrezno konfigurira svoj strežnik.