Çerezler Kütüphanesi

Çerez oluşturma, kullanma ve silme gibi işlemleri gerçekleştiren sınıftır.

Kurulum

Bu bileşen KUT ile birlikte gelir; ayrıca kurulum gerektirmez.

↓ Paket KUT ile birlikte gelir.

Yapılandırma

INI Yapılandırması

Bu ayarların kullanımı Session kütüphanesinde anlatılan kullanımla aynıdır.

Yöntemler

Insert

Çerez oluşturmak için kullanılır.

Parametreler

Kullanımı

Cookie::insert('example', 'Example Data');

echo Cookie::select('example');

İstenirse değer olarak dizi verisi de tutulabilir.

Cookie::insert('example', ['a', 1, 'b']);

output(Cookie::select('example'));

Doğrudan Erişim

Cookie::example('Example Data');

Select

Oluşturulan çerezleri kullanmak için kullanılır. Eğer oturum bulunmazsa FALSE değeri döner.

Parametreler

Kullanımı

Cookie::insert('example', 'Example Data');

echo Cookie::select('example');

Doğrudan Erişim

echo Cookie::example();

SelectAll

Oluşturulan tüm çerezlerin değerlerini dizi olarak almak için kullanılır.

Parametreler

Kullanımı

Cookie::insert('example', ['a', 1, 'b']);
Cookie::insert('value', 'Value');

output(Cookie::selectAll());

Doğrudan Erişim

output(Cookie::all());

Delete

Oluşturulan çerezleri silmek için kullanılır.

Parametreler

Kullanımı

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

Doğrudan Erişim

Cookie::exampleDelete();

DeleteAll

Oluşturulan tüm çerezleri silmek için kullanılır.

Parametreler

Kullanımı

Cookie::insert('example', ['a', 1, 'b']);
Cookie::insert('value', 'Value');
Cookie::deleteAll();

output(Cookie::selectAll());

Time

Çerezin yaşam süresini belirlemek için kullanılır. Opsiyonel yöntemdir. Cookie::insert() yönteminin 3. parametresi yerine kullanılır.

Parametreler

Kullanımı

Cookie::time(60 * 60 * 24)->insert('oneDay', 'One Day');

Path

Çerezin tutulacağı dizini belirlemek için kullanılır. Opsiyonel Yöntemdir.

Parametreler

Kullanımı

Cookie::path('/cookies/')->time(60 * 60 * 24)->insert('example', 'Example Value');

Domain

Çerezinin hangi alan isimleri için geçerli olacağını belirlemek için kullanılır. Opsiyonel Yöntemdir.

Parametreler

Kullanımı

Cookie::domain('example.com')
      ->path('/cookies/')
      ->time(60 * 60 * 24)
      ->insert('example', 'Example Value');

Secure

Çerezin istemciye güvenli bir HTTPS bağlantısı üzerinden mi aktarılması gerektiğini belirtmek için kullanılır. TRUE belirtildiği takdirde, çerez sadece güvenli bağlantı mevcutsa gönderilecektir. Opsiyonel Yöntemdir.

Parametreler

Kullanımı

Cookie::secure(true)
      ->domain('example.com')
      ->path('/cookies/')
      ->time(60 * 60 * 24)
      ->insert('example', 'Example Value');

Encode

Çerezin 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 -> cookie ayarları içinde ön tanımlı olarak anahtarın şifrelenmesi için kullanılan encode ayarı md5 olarak ayarlıdır.

Parametreler

Kullanımı

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

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

Decode

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

Parametreler

Kullanımı

Cookie::encode('md5')->insert('value', 'Cookie Value');

Output::writeLine(Cookie::decode('md5')->select('value'));

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

Cookie::encode('md5', 'sha1')->insert('value', 'Cookie Value');

Output::writeLine(Cookie::decode('md5')->select('value'));

// Config/Storage.php
"cookie" => [
    "secure"   => null,
    "httpOnly" => true,
    "sameSite" => "Lax"
]