Oturum Kütüphanesi

---

PHP session işlemlerini daha pratik, kullanışlı ve güvenli halete getiren sınıftır.

 

 

# Kurulum

---

ZN dağıtımları için kurulum gerekmez.

↓ composer require znframework/package-storage

 

 

# Yöntemler

---

1.0.0	bool	insert(string $name, $value)
		6.0.0	this	first(void)
		6.0.0	this	last(void)
1.0.0	mixed	select(string $name)
1.0.0	array	selectAll(void)
1.0.0	bool	delete(string $name)
1.0.0	bool	deleteAll(void)
3.1.2	this	encode(string $name, string $value)
3.1.2	this	decode(string $hash)
2.0.5	this	regenerate(bool $regenerate = true)

 

 

# Yapılandırma

---

string	$encode = 'super'	Oturum anahtarlarının hangi algoritma ile şifreleneceğidir. Belirtilmezse şifreleme yapılmaz.
	Seçenekler	super, golden, md5, sha1 ...
bool	$regenerate = true	Oturum kimliğinin değiştirilmesi durumu. Güvenlik açışıdaın bu değerin true olması tercih edilir.

 

 

# INI Yapılandırması

---

Session yani oturum işlemlerinin htaccess veya php_ini ayarlarını yapılandırmak için oluşturulmuş yapılandırma dosyasıdır.

INI
array	$settings = []	php.ini Oturum ayarları listesi. Bu ayarların kullanımı hakkında detaylı bilgiye PHP Ini Yönergeleri bağlantısı üzerinden ulaşabilirsiniz.

Htaccess
bool	$status = false	Settings bölümündeki ayarların .htaccess dosyasına kaydedilip kaydedilmeyeceğini belirler. TRUE olması durumda ayarlar .htaccess dosyasına kaydedilir. FALSE olması durumuda sadece php_ini üzerinden yapılandırmaya çalışır.

 

 

# Insert (ZN >= 1.0.0)

---

Oturum verisi oluşturmak için kullanılır.

Parametreler

string	$name	Oturum adı.
mixed	$value	Değer.
return	bool

Opsiyonel Yöntemler

6.0.0	this	first(void)	Bir oturum dizisinin başına eleman ekler. Session::insert() işleminin bu yöntemle birlikte yapılması durumunda session verisi dizi türünde saklanır.
6.0.0	this	last(void)	Bir oturum dizisinin sonuna eleman ekler. Session::insert() işleminin bu yöntemle birlikte yapılması durumunda session verisi dizi türünde saklanır.

Kullanımı

Session::insert('example', 'Example Data');
echo Session::select('example');

Session::example('Example Data');

 

 

# Select (ZN >= 1.0.0)

---

Oluşturulan oturumları seçmek için kullanılır.

Parametreler

string	$name	Oturum adı.
return	mixed

Kullanımı

Session::insert('example', ['a', 'b', 'c']);
output(Session::select('example'));

output(Session::example());

 

 

# SelectAll (ZN >= 1.0.0)

---

Oluşturulan tüm oturumları seçmek için kullanılır.

Parametreler

void
return	array

Kullanımı

Session::insert('example', 'Example Data');
Session::insert('value', 'Value');
output(Session::selectAll());

output(Session::all());

 

 

# Delete (ZN >= 1.0.0)

---

Olutuşturulan oturumları silmek için kullanılır.

Parametreler

string	$name	Oturum adı.
return	bool

Kullanımı

Session::delete('example');
output(Session::selectAll());

Session::exampleDelete();

 

 

# DeleteAll (ZN >= 1.0.0)

---

Olutuşturulan tüm oturumları silmek için kullanılır.

Parametreler

void
return	bool

Kullanımı

Session::deleteAll();
output(Session::selectAll());

array (size=0) empty

 

 

# Encode (ZN >= 3.1.2)

---

Oturum oluştururken hem değeri tutacak anahtarı hemde değerin kendsini şifrelemek için kullanabilirsiniz. Burada dikkat edilmesi gereken nokta anahtar şifrelemesi çözümlenebilirken değerin şifrelemesi çözümlenememektedir. Ön tanımlı olarak Config/Services.php -> session ayarları içinde ön tanımlı olarak anahtarın şifrelenmesi için kullanılan encode ayarı md5 olarak ayarlıdır.

Parametreler

string	$encodeName	Oturum değerini tutacak anahtarın şifrelenmesi için kullanılır. Boş bırakılması halinde hiç bir şifreleme yapmaz.
string	$encodeValue	Oturum verisini şifrelemek için kullanılır. Boş bırakılması halinde hiç bir şifreleme yapmaz.
return	this

Kullanımı

Session::encode('md5')->insert('sessionValue', 'Session Value');
Session::encode('sha1')->insert('sessionValue', 'Session Value');

\Output::writeLine(Session::decode('md5')->select('sessionValue'));
\Output::writeLine(Session::decode('sha1')->select('sessionValue'));

 

 

# Decode (ZN >= 3.1.2)

---

Session::encode() ile şifrelenmiş oturum adını çözer. Şifreleme değer için tek yönlü olarak yapıldığı için çözümlenemez.

Parametreler

string	$encodeName	Oturum değerini tutacak anahtarın şifrelenmesi için kullanılır. Boş bırakılması halinde hiç bir şifreleme yapmaz.
return	this

Kullanımı

Session::encode('md5')->insert('sessionValue', 'Session Value');

\Output::writeLine(Session::decode('md5')->select('sessionValue'));

İstenirse oturumun değeride şifrelenebilir. Ancak bu kullanımda verinin çözümlenmesi mümkün değildir.

Session::encode('md5', 'sha1')->insert('sessionValue', 'Session Value');

\Output::writeLine(Session::decode('md5')->select('sessionValue'));

 

 

# Regenerate (ZN >= 2.0.5)

---

Geçerli oturum kimliğini yenisiyle değiştirir. Ancak bu yöntem Session kütüphanesi için otomatik olarak kullanıldığından tekrar kullanımına gerek yoktur. Regenerate işleminin otomatik olarak yapılmamasını sağlamak için Config/Services.php -> session -> regenerate ayarının true değeri false olarak ayarlanmalıdır.

Parametreler

string	$regenerate	Oturum kimliği değiştirilsin mi?
return	this

Kullanımı

Session::insert('example', 'Example Data');
Session::regenerate();