php logger

bibliothèque php logger

version espagnole

Bibliothèque Php pour créer facilement des logs et les stocker au format Json.

---

• Exigences
• Installation
• Méthodes disponibles
• Démarrage rapide
• Méthodes disponibles
• Usage
• Essais
• Parrainer
• Licence

---

Exigences

Cette bibliothèque est prise en charge par les versions PHP 5.6 ou supérieures et est compatible avec les versions HHVM 3.0 ou supérieures.

Installation

La méthode préférée pour installer cette extension est via Composer.

Pour installer la bibliothèque php logger , simplement :

 composer require Josantonius/Logger

La commande précédente n'installera que les fichiers nécessaires, si vous préférez télécharger l'intégralité du code source, vous pouvez utiliser :

 composer require Josantonius/Logger --prefer-source

Vous pouvez également cloner le dépôt complet avec Git :

$ git clone https://github.com/Josantonius/PHP-Logger.git

Ou installez-le manuellement :

Téléchargez Logger.php :

 wget https://raw.githubusercontent.com/Josantonius/PHP-Logger/master/src/Logger.php

Téléchargez Json.php :

 wget https://raw.githubusercontent.com/Josantonius/PHP-Json/master/src/Json.php

Images

Méthodes disponibles

Méthodes disponibles dans cette bibliothèque :

- Initiateur de la gestion du débogage du site

 new Logger ( $ path , $ filename , $ logNumber , $ ip , $ states );

Attribut	Description	Taper	Requis	Défaut
$chemin	Nom du chemin pour enregistrer le fichier avec les journaux.	chaîne	Non	nul
$nom de fichier	Nom du fichier JSON qui enregistrera les journaux.	chaîne	Non	nul
$logNuméro	Nombre maximum de journaux à enregistrer dans un fichier.	int	Non	200
$ip	Si vous souhaitez accéder à une autre bibliothèque.	chaîne	Non	nul
$états	Différents états pour les journaux.	tableau	Non	nul

# Retour (nul)

- Enregistrer la ligne de journal

Logger:: save ( $ type , $ code , $ msg , $ line , $ file , $ data );

Attribut	Description	Taper	Requis	Défaut
$type	Type d'erreur ou avertissement.	chaîne	Oui
$code	Code d'état de la réponse HTTP.	int	Oui
$message	Message.	chaîne	Oui
$ligne	Ligne à partir de laquelle la sauvegarde est exécutée.	int	Oui
$fichier	Chemin du fichier à partir duquel la méthode est appelée.	chaîne	Oui
$données	Paramètres personnalisés supplémentaires.	tableau	Non	0

# Retour (booléen)

- Enregistrer les journaux dans le fichier Json

Logger:: store ();

# Retour (booléen)

- Obtenez des journaux enregistrés

Logger:: get ();

# Retour (tableau) → journaux enregistrés

- Définir le répertoire pour les scripts et obtenir l'URL du fichier

Logger:: script ( $ url );

Attribut	Description	Taper	Requis	Défaut
$url	URL du fichier.	chaîne	Oui

# Retour (chaîne) → URL du fichier

- Définir le répertoire pour les styles et obtenir l'URL du fichier

Logger:: style ( $ url );

Attribut	Description	Taper	Requis	Défaut
$url	URL du fichier.	chaîne	Oui

# Retour (chaîne) → URL du fichier

- Obtenir le nombre de journaux ajoutés dans la section actuelle

Logger:: added ();

# Retour (int) → journaux ajoutés dans la section actuelle

- Afficher la section enregistreur

Logger:: render ();

# Retour (booléen vrai)

- Réinitialiser les paramètres

Logger:: reset ();

# Retour (booléen vrai)

Démarrage rapide

Pour utiliser cette bibliothèque avec Composer :

 require __DIR__ . ' /vendor/autoload.php ' ;

use Josantonius  Logger  Logger ;

Ou Si vous l'avez installé manuellement , utilisez-le :

 require_once __DIR__ . ' /Logger.php ' ;
require_once __DIR__ . ' /Json.php ' ;

use Josantonius  Logger  Logger ;

Usage

Exemple d'utilisation de cette bibliothèque :

- Exemple de base

 <?php
require __DIR__ . ' /vendor/autoload.php ' ;

use Josantonius  Logger  Logger ;

new Logger ();

Logger:: save ( ' SUCCESS ' ,  100 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' JOIN ' ,     200 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' INFO ' ,     300 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' WARNING ' ,  400 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' ERROR ' ,    500 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' FATAL ' ,    600 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' REQUEST ' ,  700 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' RESPONSE ' , 800 , ' msg ' , __LINE__ , __FILE__ );

Logger:: storeLogs ();

- Exemple avancé

 <?php
require __DIR__ . ' /vendor/autoload.php ' ;

use Josantonius  Logger  Logger ;

$ states  = [

  ' global '    => true ,
  ' exception ' => true ,
  ' error '     => false ,
  ' notice '    => false ,
  ' fatal '     => true ,
];

new Logger ( ' /logger/ ' , ' logs ' , 600 , ' 58.80.84.44 ' , $ states );

Logger:: save ( ' EXCEPTION ' , 400 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' ERROR ' ,    402 , ' msg ' , __LINE__ , __FILE__ );
Logger:: save ( ' NOTICE ' ,    100 , ' msg ' , __LINE__ , __FILE__ );

$ params = [

  ' id-user '   => 68 ,
  ' name-user ' => ' Joe '
]; 
        
Logger:: save ( ' FATAL, 500, ' msg', __LINE__ , __FILE__ , $ params );

Logger:: storeLogs ();

echo ' Logs added: ' . Logger:: added ();

echo ' Logs added: ' . count (Logger::get);

printf ( ' <link href="%s"> ' , Logger:: style ( ' http://site.com/public/css/ ' ));

printf ( ' <script src="%s"> ' , Logger:: script ( ' http://site.com/public/js/ ' ));

Logger:: render ();

Essais

Pour exécuter des tests, vous avez juste besoin de composer et d'exécuter ce qui suit :

 git clone https://github.com/Josantonius/PHP-Logger.git

cd PHP-Logger

composer install

Exécutez des tests unitaires avec PHPUnit :

 composer phpunit

Exécutez les tests standards du code PSR2 avec PHPCS :

 composer phpcs

Exécutez les tests PHP Mess Detector pour détecter les incohérences dans le style de code :

 composer phpmd

Exécutez tous les tests précédents :

 composer tests

Parrainer

Si ce projet vous aide à réduire votre temps de développement, vous pouvez me sponsoriser pour soutenir mon travail open source ?

Licence

Ce référentiel est sous licence MIT.

Copyright © 2017-2022, Josantonius