Seyir Defteri


    × Bunları biliyor muydunuz?
"Dinamik bir kütüphaneyi tanımlarken sınıf isminin başına Internal ön eki getirirerek statik erişimli hale getirebilirsiniz. "


Seyir defteri kayıt altına tutulması istediğiniz verileri bir dosya üzerinde saklamak için oluşturulmuştur. Bundan önceki sistemlerde report() yöntemi ile yapılan bu işlem belirtilen sürüm itibari ile sınıf olarak kullanılacak yapıya dönüştürülmüştür. Loglama işleminin yapılabilmesi için her projenin kendine ait ilgili yapılandırma dosyasından loglama işleminin aktif hale getirilmesi gerekmektedir.

 

 

# Kurulum


ZN SE ve ZN CE dağıtımları için terminal kurulum komutu.

↓ composer require znframework/package-helpers

 

 

# Yapılandırma


Dosya: Config/Project.php

Sistemin veya kullanıcıların loglama yapabilmesi için yukarıda yolu belirtilen dosyadan log -> createFile değerinin true olarak ayarlaması gerekmektedir.

LOG
Bool $createFile = false Loglama işlemini devreye sokar.
String $fileTime = '30 day' Log kayıtlarının ne kadar süre ile saklanacağını belirtir.

 

 

# Yöntemler


Bool report(String $subject, String $message, String $destination = NULL, String $time = NULL)
Bool notice(String $message, String $time = NULL)
Bool emergency(String $message, String $time = NULL)
Bool alert(String $message, String $time = NULL)
Bool error(String $message, String $time = NULL)
Bool warning(String $message, String $time = NULL)
Bool critical(String $message, String $time = NULL)
Bool info(String $message, String $time = NULL)
Bool debug(String $message, String $time = NULL)

 

 

# Report (ZN >= 5.0.0)


Log kayıtı oluşturmak için kullanılır.

Parametreler

String $subject Kayıtın konusu.
String $message Kayıtın içeriği.
String $destination = NULL Kayıtın amacı.
String $time = NULL Kayıtın ne kadar süre ile tutulacağı. Belirtilmezse yapılandırma dosyasında belirtilen süre kabul edilir.
Return Bool

Kullanımı

Logger::report('User Login', 'Login Error', 'UserLogin', '10 month');

Yukarıda User Login konulu Login Error mesajlı dosya adı UserLogin olan ve 10 ay süreyle tutulacak olan bir kayıt tutmuş olduk. Aşağıda oluşturulan dosyanın yolu verilmiştir.

Created Log File: Storage/Logs/UserLogin.log

 

 

# Diğer Yöntemler (ZN >= 5.0.0)


Yukarıda belirtilen report() dışındaki diğer yöntemlerin kullanımı tamamen aynı olup sadece 2 parametre içerir. Bunlar kayıtın içeriği ve tutulacağı süredir. Konusunu ve amacını yöntem ismine göre alır.

Logger::notice('Notice Example Message');
Created Log File: Storage/Logs/notice.log
Logger::warning('Warning Example Message');
Created Log File: Storage/Logs/warning.log

 

 

# Bir Log Dosyasının İçeriği


Yukarıdaki yöntemlerle oluşturulan log dosyalarının içeriği aşağıdakine benzer formda yer alır.

IP: 127.0.0.1 | Subject: Example  | Date: 10.01.2000 20:00:00 | Message: Log Message
IP: 127.0.0.2 | Subject: Example2 | Date: 10.01.2000 20:00:00 | Message: Log Message2